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I.  INTRODUCTION 


The  analysis  of  requirements  has  been,  and  continues  to 
be,  a  source  of  difficulty  in  developing  software.  The 
impact  of  improper  analysis  is  far  reaching.  Consequently, 
considerable  effort  has  been  put  into  developing 
methodologies  to  elicit  and  accurately  capture  what  is 
needed  and  wanted.  The  traditional  strategy  for  conducting 
requirements  analysis  has  been  to  interview  users 
individually  and  then  to  document,  in  ordinary  English,  the 
users'  needs.  The  result  of  this  process  is  a  large  tome  of 
requirements  that  is  seldom  understood  in  its  entirety. 
However,  requirements  analysis  is  the  foundation  effort  for 
any  software  system  and  therefore  of  particular  importance 
for  achieving  project  success.  The  foundation  is  provided 
by  uncovering  the  flow  and  structure  of  data. 

The  software  to  be  built  it  described  by  several 
completion  of  several  actions.  Design  constraints  must  be 
identified  to  bound  the  problem  and  clarify  its  scope. 
Functions  and  data  must  be  described  to  permit  an 
understanding  of  the  essence  of  the  system  to  be  automated. 
Interface  details  for  hardware,  software,  human  beings  and 
procedures  must  be  developed  to  integrate  the  software  into 
the  encompassing  system  or  organization.  Important  to 
describing  the  software  is  establishing  and  maintaining 
communications  with  both  the  eventual  user  and  the 
originating  requestor.  The  information  flow  and  structure 
becomes  a  tool  that  leads  to  an  overall  representation  of 
the  software  which  will  be  developed.  Thus,  the  design 
process  is  fed  the  output  of  the  requirements  analysis 
effort.  The  continuity  of  the  effort  and  the  quality  of  the 
design  are  heavily  dependent  on  the  requirement 
specification.  [Ref.  1] 


There  are  several  problems  with  the  requirement  analysis 
effort  as  exercised  in  the  traditional  software  life  cycle. 
First,  users*  needs  may  change  significantly  during 
development.  This  can  occur  through  a  natural  evolution  of 
the  organization  or  through  interaction  with  the  software 
development  effort.  Secondly,  the  user  has  no  system  during 
the  period  between  the  solicitation  of  requirements  and 
delivery  of  the  completed  system.  The  user  has  no  clear 
picture  of  what  he  will  be  getting  because  he  has  only  been 
dealing  with  abstract  terms  and  representations,  nothing 
that  actually  behaves  like  the  real  system.  [Ref.  2] 

The  reasons  for  some  of  these  problems  are  known.  The 
people  involved  do  not  share  the  same  frames  of  reference 
because  analysts  and  end-users  coma  from  different  cultures. 
An  analyst  can  be  viewed  as  a  missionary  steeped  in  computer 
technology.  An  end-user  is  only  concerned  with  getting  the 
job  done  within  his  particular  business  area.  The  two 
usually  do  not  understand  each  ethers*  area  of  expertise  and 
a  great  deal  of  learning,  particularly  for  the  analyst,  must 
take  place.  The  product  resulting  from  the  interaction  of 
an  analyst  and  a  user  is  often  a  document  of  which  too  much 
is  expected.  The  medium  of  a  textual  document  may  capture 
many  relevant  details,  but  it  may  not  in  turn  communicate 
them  with  sufficient  clarity  to  permit  true  understanding. 

A  specification  document  is  often  too  long;  contains 
technical  terms  the  user  does  not  know;  contains  words  with 
different  meaning  to  users  and  analysts  and  often  also 
contains  trivia  and  motherhood  statements  which  sound  good 
but  offer  no  real  benefit.  A  textual  specification  can  be 
particularly  lacking  regarding  interactive  systems  because  a 
document  cannot  capture  the  dynamic  quality  of  the  user 
interaction. 

Nevertheless,  the  textual  document  as  a  requirement 
specification  is  the  basis  for  all  follow  on  work.  This 


work  cannot  be  correct  if  its  basis  is  inaccurate.  Despite 
users  not  always  understanding  the  specifications,  they  are 
often  coerced  into  signing  and  approving  the  document 
because  the  developers  refuse  tc  go  forward  without  a 
signature.  The  developers  feel  it  is  necessary  to  have  user 
approval  and  the  requirements  frozen  to  prevent  having  to 
make  changes  which  increase  system  cost  further  along  in  the 
development  process.  However,  the  freezing  of  requirements 
specifications  causes  apprehension  for  both  users  and 
developers.  Developers  either  intuitively  feel  or  know  from 
experience  that  the  act  of  providing  what  an  end-user  needs, 
and  the  follow  on  design  and  coding  effort,  changes  his 
perception  of  those  needs.  The  solution  to  a  problem  can 
change  the  problem  [  Bef .  3].  The  essence  of  the  problem  of 
inadequate  requirement  specifications  is  the  incomplete 
communications  between  the  user  and  the  analyst.  The 
evidence  that  inadequate  communications  is  still  a  problem 
lies  in  the  fact  that  software  software  development  projects 
still  suffer  from  poorly  defined  specifications  despite  the 
considerable  effort  that  has  been  expended  in  in  developing 
and  using  rigorous  methodologies.  Some  observers  feel  the 
failure  rate  is  just  as  high  as  it  was  15  years  ago  and  that 
most  development  is  a  trial  and  error  process  [Ref-  4  ]. 

Requirements  specifications  can  take  one  of  three  forms. 
The  traditional  approach  is  to  develop  a  textual  list  of 
’’shall  statements”  the  system  must  fulfill.  A  major 
disadvantage  of  the  textual  approach  is  the  psychological 
distance  from  what  the  user  will  eventually  receive.  A 
document  does  not  convey  a  realistic  sense  of  how  the  system 
will  fit  the  user's  needs.  This  is  especially  true  for 
interactive  systems.  Textual  specifications  take  a  static 
view  in  attempting  to  capture  or  freeze  the  situation.  Host 
users  cannot  fully  describe  their  current  requirements  and 
even  fewer  can  identify  their  future  needs.  A  more  recent 


innovation  is  the  use  of  an  interpretive  model.  An  example 
of  this  approach  is  the  Structured  Analysis  Design  Technique 
which  uses  a  set  of  graphical  representations.  Other 
interpretive  modeling  techniques  are  the  use  of  data  flow 
diagrams,  flowcharts  and  Nassi-Schneidermann  charts.  These 
approaches,  although  an  improvement  over  the  textual,  still 
do  not  adequately  communicate  on  line- interaction.  Using 
more  detailed  graphics  places  mere  burden  on  the  users  than 
it  helps.  However,  users  know  what  would  be  useful  if  they 
saw  it  [Bef.  5].  A  useful  approach  is  to  develop  a  working 
model,  a  prototype.  The  development  of  higher  level 
languages  and  the  lessening  cost  of  hardware  have  recently 
given  rise  to  a  requirements  analysis  approach  which  offers 
promise  of  assisting  in  the  communications  problem.  This 
technique  is  prototyping. 

Chapter  2  is  devoted  to  explaining  the  concept  of 
prototyping.  A  key  to  successful  prototyping,  if  not  all 
systems  analysis,  is  the  capture  of  data  about  the  data  in 
some  form.  Data  dictionaries  are  the  means  most  often  used 
for  organizing  this  "metadata".  Chapter  3  will  discuss 
metadata  and  data  dictionaries  and  their  potential  role  in 
the  system  analysis  and  design  process.  By  explaining 
prototyping  and  data  dictionaries  we  will  show  the  two  as  an 
inseparable  pair  which  are  an  important  adjunct  to  the 
system  development  process.  The  culmination  of  this  thesis 
is  chapter  h  wherein  we  develop  a  general,  relational-based 
design  of  a  data  dictionary  for  use  with  prototyping  for 
requirements  analysis.  This  dictionary  will  be  implemented 
using  dbase  II,  a  micro-oriented  relational  database 
management  system. 
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II.  PROTOTYPING  FOB  SOFTBiHE  REQUIREMENTS 


A.  DEFINITION  OF  PROTOTYPING 

Webster’s  dictionary  defines  a  prototype  as  one  of 
three  possible  things: 

1.  An  original  or  model  after  which  anything  is  formed 

2.  The  first  thing  of  its  kind 

3.  A  pattern,  an  exemplar,  an  archetype 

The  second  definition  is  probably  the  most  relevant  to  this 
discussion  because  prototypes  are  being  used  in  data 
processing  as  a  first  attempt  at  a  design  which  is  then 
extended  or  enhanced.  In  general  systems  development,  a 
prototype  is  known  as 

"...a  partially  complete  functional  model  of  a  target 
system  whose  purpose  is  to  provide  a  better  under¬ 
standing  of  the  target  system’s  requirements"  [Ref.  6  3. 

A  software  prototype  is  characterized  by  the  following 
features.  It  is  a  working  system,  although  of  limited 
capability,  rather  than  just  an  idea  on  paper.  A  prototype 
may  become,  after  iterative  enhancement,  a  production 
system.  Its  original  purpose  is  to  test  out  assumptions 
about  requirements  and/or  system  design  architecture.  A 
prototype  is  created  quickly.  This  has  become  possible  only 
in  recent  years  with  more  powerful  languages  which  are  less 
procedurally  oriented.  Some  would  argue  however,  that 
prototyping  was  the  way  software  was  developed  before  the 
advent  of  functional  decomposition  and  the  system 
development  life  cycle  which  is  generally  accepted  and  used 
today. 


'•In  the  early  days  of  software  development  writing 
programs  was  the  thing  to  do.  After  an  explanation  of 
the  problem,  a  period  of  questions  and  answers,  and 
research  into  tne  nuts  ana  bolts  of  a  method,  the 
programmer  began  his  or  her  work.  Starting  with  that 
portion  of  the  problem  that  was  well  understood,  lines 
of  FORTRAN.  COBOL  or  ALGOL  would  begin  to  appear.  As 
time  passed  additional  portions  were  coded  until  the 
entire  program  was  complete.  Design  was  conducted 
implicitly,  if  at  all!  "  [Ref.  7] 


A  prototype  should  be  inexpensive  to  build,  at  least  less 
than  it  would  cost  if  a  conventional  high  level  language 
were  used.  Indeed,  prototyping  in  data  processing  originated 
only  recently  because  until  now  programming  a  prototype  was 
just  as  costly  as  programming  the  working  system  [fief.  8]« 
The  important  point  is  to  get  something  running  soon  to 
establish  effective  communications  with  the  user  without  the 
use  of  extravagant  resources.  The  follow  on  development  of 
a  prototype  is  a n  iterative  process  in  which  improvements 
are  made  in  small  increments  as  the  user  and  developer  work 
together  and  discover  new  requirements  [Ref.  9]. 

Mitchell  Spiegel,  formerly  of  Hang  Laboratories, 
explains  the  prototyping  approach  as: 


"...a  process  of  modeling  user  requirements  in  one  or 
more  levels  of  detail,  including  working  models. 

Project  resources  are  allocated  to  produce  scaled  down 
versions  of  the  software  described  by  r eguirements. 

The  prototype  version  makes  the  software  visible  for 
review  by  users,  designers  and  management.  This  process 
continues  as  desired,  with  running  versions  ready  for 
release  after  several  iterations.  "  [Ref.  10] 


Traditional  management  information  system  development 
follows  a  series  of  steps  (see  Figure  2.1).  Prototyping  is 
considered  as  an  adjunct  activity  to  the  specification  of 
requirements  (see  Figure  2.2).  The  results  of  prototyping 
are  input  to  the  steps  following  requirements  analysis,  but 
may  or  may  not  be  used  actively  in  those  steps. 

Three  alternatives  are  possible  for  the  disposition  of  a 
prototype.  Having  served  the  purpose  of  facilitating 
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requirements  definition  the  prototype  can  oe  discarded.  The 
lessons  learned  are  transferred  to  a  requirements 
specification  and  development  of  the  system  then  follows  the 
traditional  system  development  cycle.  A  second  alternative 
is  to  maintain  the  prototype  and  run  it  in  parallel  with  the 
developing  target  system.  The  benefit  of  this  choice  is  the 
availability  of  a  partially  functional  system  to  the  users 
until  the  fully  capable  system  can  be  delivered.  Lastly, 
the  prototype  can  continue  to  be  iteratively  refined  to 
become  the  target  system.  This  alternative  is  usually  only 
feasible  in  management  information  systems  as  opposed  to 
embedded  software,  such  as  weapon  control  systems  [Bef.  11]. 
Some  would  argue  that  the  term  prototype  should  only  be 
applied  to  those  instances  where  the  system  is  to  be  thrown 
away,  otherwise  it  is  more  appropriate  to  term  the  activity 
as  evolutionary  development  [Bef.  12].  The  purpose  of  the 
distinction  is  to  insure  that  only  the  right  decisions  are 
kept  and  transferred  to  the  requirements  specification  while 
the  mistakes,  especially  those  causing  poor  execution 
efficiency,  are  left  behind  with  the  prototype. 

B.  ADVANTAGES  OF  PBOTOTIPING 

There  are  several  advantages  associated  with  the  use  of 
prototyping.  The  primary  argument  for  using  prototypes  is 
that  the  specifications  which  result  are  more  complete 
because  users  can  evaluate  a  prototype  better  than  they  can 
evaluate  written  specifications.  In  using  the  prototype  the 
users  encounter  and  think  about  problems  they  will  have  with 
the  production  system  [Bef.  13].  Another  benefit  is  that 
prototyping  allows  and  encourages  users  to  change  their 
minds  about  what  they  want.  Consequently,  the  eventual 
system  is  better  customized  and  therefore  more  useful.  This 
relates  to  the  idea  that  the  development  process  itself 
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Figure  2.1  Steps  in  Traditional  Systen  Development 

changes  the  users'  perceptions  of  what  is  possible, 
increasing  their  insights  into  the  development  process  and 
affecting  it.  In  fact,  this  idea  is  a  loose  corollary  of 
the  Heisenberg  Uncertainty  Principle  which  states  that  any 
system  development  activity  inevitably  changes  the 
environment  out  of  which  the  need  for  the  system  arose 
[Ref.  14].  Some  argue  that  prototyping  eliminates  the 
surprises  at  the  end  of  the  traditional  development  process 
because  specifications,  some  being  erroneous,  haven't  been 
frozen  and  pursued  without  correction.  Another  argument  is 
that  prototyping  shortens  the  development  cycle,  but 
experience  to  date  has  found  this  not  always  to  be  the  case 
anl  that  prototyping  only  more  clearly  defines  what  has  to 
be  done.  Of  importance  to  those  suffering  with  technically 
oriented  data  processing  personnel  who  have  difficulty 
relating  to  people  is  the  benefit  that  prototyping  does  not 
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Figure  2.2  System  Development  Dsing  Prototyping 


require  interviewing  skills  to  the  same  degree  as  a 
traditional  methc5  of  defining  requirements.  Also,  because 
prototyping  requires  spending  more  time  with  users,  the 
systems  analysts  are  forced  to  become  more  user  oriented  and 
aware  of  the  user’s  environment. 

The  emphasis  on  the  user  is  the  key  issue  here  and 
further  benefits  are  possible.  The  availability  of  a 
prototype  enables  the  user  to  evaluate  the  human  interfaces 
in  practice  and  suggest  changes.  Ihe  user  gets  a  more 
personalized  system,  regardless  of  the  efficacy  of  the 
changes  suggested.  Thus  the  user  is  more  willing  to  accept 
the  eventual  system  having  the  perception  that  he  truly 
affected  its  shape. 

A  working  pro4  otype  enables  the  developer  to  evaluate 
the  users’  performance  with  the  human  interface  and  to 


modify  it  to  minimize  errors.  Experimentation  is 
facilitated  by  implementing  alternative  interfaces  without 
having  to  suffer  the  tedium  of  drawing  specification 
graphics  of  one  sort  or  another. 

It  is  possible  to  generate  human-machine  dialogues  and 
to  make  minor  changes  quickly. 

The  existence  of  a  prototype  gives  the  user  a  more 
immediate  sense  of  the  proposed  system  and  encourges  him  to 
think  more  carefully  about  both  the  needed  and  the  desirable 
characteristics  of  the  system.  It  is  easy  to  write 
statements  in  a  requirements  document  which  say  "the  system 
shall  do  x"  and  "the  system  shall  be  capable  of  y". 

However,  both  the  developer  and  the  user  get  a  more 
realistic  feeling  for  the  effort  and  cost  of  a  feature  when 
they  must  actually  add  it  to  a  working  model.  Thus,  the 
eventual  model  better  represents  what  is  feasible  than  a 
document  with  a  series  of  "shall  statements".  It  is 
particularly  significant  to  note  that  in  a  typical 
development  effort  there  is  a  long  time  between  analysis  and 
construction.  The  user  only  has  a  limited  idea  of  what  the 
system  will  do  in  such  a  case.  Therefore,  it's  difficult 
for  the  user  to  be  specific  when  dealing  only  with  abstract 
terms.  Even  though  the  functionality  of  a  prototype  system 
is  minimal  the  user  is  forced  to  think  more  carefully  about 
the  task  being  automated.  This  should  produce  a  more 
accurate  understanding  of  the  problem  [Hef.  15].  The 
biggest  argument  for  prototyping  is  that,  unlike  traditional 
methods,  it  builds  an  effective  bridge  across  the 
communications  gap  between  the  user  and  the  analyst. 

C.  DISADVAHTAGES  OF  PBOTOTYPIHG 

Prototyping  has  some  decided  disadvantages  as  well. 
Prototyping  makes  it  difficult  to  plan  resource  use  because 
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a  clear  path  of  what  you  will  be  doing  and  when  isn’t 
provided.  It  also  makes  it  difficult  to  decide  whether  to 
enhance  an  old  system  or  build  a  new  one.  Analysts  and 
users  can  become  bored  after  the  nth  iteration  of  the 
prototype.  In  using  the  traditional  development  process 
there  are  specific  requirements  which,  when  met  by  proof  of 
validation,  clearly  mark  the  job  as  complete.  Because  the 
prototype  is  changing  continually,  it  creates  a  problem 
keeping  users  abreast  of  the  current  version. 

Prototyping  can  cause  a  reduction  in  discipline  for 
proper  documentation  and  testing.  Because  there  is  less 
emphasis  on  hard  thinking  and  ’’desk  checking"  there  is  a 
greater  chance  of  missing  a  basic  problem  which  could  negate 
assumptions  essential  to  the  design  being  developed.  For 
large  systems  it  is  often  not  clear  how  the  problem  can  be 
divided  up  so  it  can  be  prototyped  a  piece  at  a  time  until  a 
traditional  requirements  study  has  been  made.  Also  there  is 
the  chance  users  may  become  so  happy  with  the  prototype  they 
consider  it  a  functional  product  and  want  the  data 
processing  people  to  start  work  on  something  else.  This  can 
create  a  higher  initial  cost  for  the  requirements  phase  and 
possible  loss  of  the  distinction  between  this  phase  and  the 
design  phase. 

A  study  using  the  ACT/1  software  package  for  prototyping 
showed  increased  needs  for  computing  resources.  If  the 
productivity  gained  from  using  prototyping  doesn't  offset 
the  cost  of  the  increased  computing  power,  then  the 
prototyping  approach  is  serving  at  a  disadvantage. 

[Ref.  16] 

D.  APPLICATIONS  AMD  GUIDANCE  FCR  PROTOTYPING 

Prototypes  can  be  usefully  applied  to  several  different 
tasks  associated  with  requirements  analysis.  These  tasks 
are  as  follows  [  Bef .  17]  : 
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1.  A  prototype  can  be  used  to  discover  the  optimum 
structure  for  the  data  about  data  (metadata).  This 
relates  to  the  engineering  use  of  prototypes  as  an 
experimental  model  from  which  to  learn. 

2.  The  prototype  can  serve  as  a  basis  for  bottom-up 
integration. 

3.  They  can  be  used  to  define  macros  that  compute  or 
derive  new  data  from  stored  data.  Abstracting  in 
this  manner  is  a  process  of  deriving  macros  from  a 
database.  The  database  is  enhanced  having  these 
macros  incorporated  into  it. 

4.  Prototypes  can  be  used  to  validate  domains.  This  is 
particularly  important  if  there  is  going  to  be  an 
active  data  dictionary  which  will  assist  in  ensuring 
data  integrity. 

5.  Prototypes  can  be  used  tc  evaluate  both  update  and 
retrieval  efficiency. 

6.  They  can  be  used  to  improve  the  physical  database 
design. 

7.  They  can  be  used  to  anticipate  changes.  This  means 
to  conduct  experiments  and  step  through  what  the  user 
will  do  with  the  system  to  gain  insight  into  how  his 
use  will  foster  new  requirements,  be  they 
modifications  or  enhancements. 

8.  They  can  be  used  to  facilitate  implementation  and 
acceptance  of  a  new  system. 

If  any  of  the  items  listed  above  seems  sufficient  to 
warrant  a  prototype  then  several  conditions  should  exist  to 
make  prototyping  an  appropriate  choice.  These  conditions  are 
as  follows: 


The  user’s  requirements  can  only  be  defined  with  much 
study. 

The  user’s  needs  are  expected  to  change  often. 

The  user  is  willing  to  cooperate  with  the  prototyper 
in  answering  questions. 

Users  are  willing  to  accept  the  prototype  as  an 
adequate  and  temporary  solution  until  an  optimized 
and  tested  system  can  be  delivered. 

The  area  of  study  is  well  defined.  Although  in  depth 
aspects  of  a  problem  aren’t  known,  the  width  or  scope 
is  confined  to  a  particular  business  area. 

Prototypes  aren't  appropriate  for  developing 
information  systems  strategies  for  an  entire 
enterprise. 

The  user  has  a  limited  set  of  objectives.  Projects 
of  large  size  with  many  different  applications  areas 
are  not  appropriate  choices  for  use  of  the 
prototyping  methodology.  The  project  must  first  be 
functionally  decomposed  to  identify  specific  business 
areas. 

A  data  dictionary  is  available  for  use.  Preferably 
an  automated,  easy-to-use  dictionary  is  available  to 
facilitate  easy  recording  of  specifications,  data 
entities,  procedures  and  whatever  else  is  necessary 
to  model  the  information  needs  of  the  user  [Bef.  18]. 
Complete  honesty  exists  between  the  user  and  the 
prototyper.  If  the  user  isn’t  satisfied,  he  should 
say  so  and  be  specific.  Further,  the  prototyper 
should  admit  ignorance  and  misunderstanding.  If  the 
answer  is  no  to  a  particular  feature  because  it  isn't 
technically  feasible,  it  should  be  so  stated  and 
explained,  not  ignored.  The  developer  must  be 
willing  to  interpret  iser  difficulties  as  requiring 
re-examination  of  the  application,  rather  than 


"educating11  the  user,  i-e.  converting  the  user  to  the 
developer’s  concept  [Bef.  19]. 

Regarding  the  last  point  above,  technical  people  are 
generally  deeply  involved  with  their  own  inventive  processes 
and  the  reasons  for  their  choices,  and  therefore  are  not 
inclined  to  consider  other  roads  which  also  admit  acceptable 
solutions. 

E.  TOOLS  FOB  PBOTOTTPIMG 

Prototyping  to  define  system  reguirements  is  a 
methodology.  A  methodology  is  a  combination  of  tools  and 
techniques  employed  within  an  organizational  and  managerial 
framework  that  can  be  consistently  applied  to  successive 
information  system  development  projects  [Bef.  20].  A 
reguirements  analysis  tool  is  any  set  of  procedures,  manual 
or  automated,  that  guides  an  analyst  through  reguirements 
specification.  A  manual  tool  is  a  well  defined  technique 
usually  with  a  mode  of  graphic  representation.  An  automated 
technique  is  often  a  specification  language  that  combines 
keyword  indicators  with  a  natural  language  feature.  There 
is  also  sometimes  a  specif icati cn  language  which,  when  fed 
to  a  processor,  produces  a  requirement  specification  and  a 
set  of  diagnostic  reports  concerning  the  consistency  and 
organization  of  the  specifications  provided.  [Bef.  21] 

The  problem  with  currently  available  manual  and 
automated  systems  is  the  necessity  of  tne  user  to  learn  some 
technical  features  to  use  the  tool.  An  argument  against 
these  techniques  is  that  the  end-user  should  not  be  burdened 
with  learning  about  the  data  processing  field.  Thus,  some 
would  argue  it's  beneficial  to  have  the  user  interact  only 
with  that  which  will  become  specif ications  for,  if  not  part 
oi,  the  eventual  system.  A  categorization  of  tools  for 
prototyping  has  been  made  and  offers  a  means  of  examining 
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what  is  available  for  use.  The  basic  requirement  for  any  of 
these  items  is  that  they  can  be  used  for  prototyping  if  they 
allow  designers  and  programmers  to  create  a  working  system 
in  a  short  period  of  time. 

The  first  category  of  tools  is  data  manipulation  systems 
or  data  base  management  systems  which  can  interface  with  a 
nonprocedural  language  to  do  data  manipulation  rather  than 
just  screen  presentation.  Such  products  as  RAMIS,  FOCUS 
and  NOMAD  are  examples  of  this  categorgy  of  tool  [Ref.  22]. 
Also  in  this  category  are  relational  data  base  management 
systems  which  some  feel  are  particularly  suited  for 
prototyping. 

Relational  data  base  management  systems  offer  a  high 
level  of  ease  of  use  and  data  independence,  both  of  which 
are  advantageous  for  prototype  development.  The  ease  of  use 
comes  from  the  simple  table  data  structures  and  the  query 
languages  associated  with  most  relational  systems.  Data 
independence  permits  simple  changes  to  logical  or  physical 
design  without  affecting  existing  programs  [Ref.  23]. 
Relational  data  base  management  systems  in  this  instance  are 
being  used  as  applications  generators.  Other  examples  of 
applications  generators  are  report  generators,  graphics 
packages,  statistical  packages  and  software  for  screen 
layout.  These  items  work  at  a  higher  level  than  another 
category  of  prototyping  tool,  program  generators. 

Program  generators  are  software  packages  which,  when 
given  specifications,  produce  source  listings,  usually  in  a 
high  order  language  such  as  COBCLr  capable  of  being  compiled 
and  executed.  Although  not  specifically  oriented  in  the 
requirements  definition  area,  they  do  provide  assistance  to 
requirements  definition  if  it  is  necessary  for  the  prototype 
to  do  actual  data  processing  These  are  particularly  helpful 
to  programmers  who  must  enhance  the  prototype  into  a 
production  system.  Such  program  generators  are  not  in 


proliferation  at  the  current  time,  but  a  sufficient  number 
exists  to  make  them  usable  in  some  development  efforts. 

Another  category  of  prototyping  tool  is  libraries  of 
reusable  code.  If  a  library  of  previously  written  routines, 
especially  screens,  exists  which  can  be  readily  implemented 
to  demonstrate  a  system's  limited  capabilities  then  the 
prototyper  can  easily  pick  and  choose.  This  saves 
considerable  effort  and  speeds  ^long  the  process.  However, 
such  a  library  must  be  well  organized  so  that  the 
individual  building  the  prototype  can  readily  identify 
modules  which  suit  his  needs  and  can  move  these  modules  into 
the  developing  prototype  with  relative  speed.  This  implies 
the  code  used  has  been  well  documented  and  generalized  to  be 
applicable  beyond  its  original  intent.  The  prototyper  must 
be  able  to  maintain  momentum  with  users  and  this  will  not 
happen  if  he  must  stop  to  develop  a  detailed  program. 

[Ref.  24] 

Hardware  as  well  as  software  should  be  considered  in 
developing  prototypes.  The  use  of  a  microprocessor  offers 
some  unique  benefits  as  a  prototyping  tool.  A  micro  can  be 
beneficial  because  it  offers  a  cheaper  alternative  when 
considering  the  cost  of  acquiring  a  fourth  generation 
language  or  a  data  base  management  system  for  a  mainframe. 

A  micro  is  portable  and  therefore  can  be  taken  to  a  user's 
area  where  currently  no  terminals  exist.  The  micro  can  be 
left  for  the  users  to  play  with  and  discuss  at  their 
convenience  without  the  possible  dampening  result  of  having 
a  data  processing  person  around.  This  way  the  end  users  are 
not  imposed  on  by  disruptive  interviews.  Finally,  having  to 
actually  implement  the  features  provides  system  builders 
better  understanding  of  what  the  user  wants  and  avoids  the 
situation  of  just  adding  verbiage  to  a  requirements 
specification.  [Ref.  25] 


F.  DATA  DRIVE H  PROTOTYPING 

There  exists  a  categorization  of  prototyping  techniques 
which  divides  all  efforts  into  1  of  2  possibilities.  The 
first  category  is  termed  applications-oriented  and  describes 
the  situation  when  the  focus  is  on  transaction  modeling  and 
simulation  technology.  Most  people  who  belong  to  this 
school  believe  prototypes  should  be  thrown  away  rather  than 
carried  forward  and  evolved.  The  other  school,  the  data 
driven  category,  believes  prototypes  should  evolve, 
extending  the  architecture  of  the  business  in  a  process  akin 
to  learning. 

The  thought  is  that  requirements  analysis  should  be  an 
open  system  which  learns  from  its  experiences.  It  holds 
that  freezing  requirements  makes  for  a  closed  system.  A 
closed  system  is  not  responsive  to  the  user  and  therefore 
doesn't  reflect  those  desires  which  will  make  the  system 
usable. 

The  data  driven  prototyping  technique  was  created  around 
an  abstraction  approach.  The  analysts  and  users  should 
abstract  from  an  entity  base  rather  than  decomposing  from  a 
functional  base.  The  data  driven  school  of  thought  contends 
that  functional  decomposition  is  not  realistic  because  its 
use  erroneously  assumes  requirements  can  be  precisely 
determined  before  system  construction  is  attempted.  The 
prototyping  approach  is  considered  valid  because  it  operates 
on  the  more  realistic  assumption  that  precise  requirements 
are  not  always  definable  until  after  construction  is 
started.  Some  argue  that  the  top  down  design  techniques, 
another  way  of  referring  to  functional  decomposition,  are 
imperative  in  nature;  that  is,  they  force  us  to  concentrate 
on  the  operations  in  the  solution  space,  with  little  regard 
for  discerning  data  structures. 


26 


The  major  difference  between  application  and  data  driven 
prototyping  is  that  the  latter  emphasizes  a  dominant  role 
and  value  for  data.  Data  prototypers  believe  entities  are 
the  essential  elements  of  learning  and  that  they  transcend 
individual  system  boundaries.  The  data  driven  school 
contends  that  functional  decomposition  is  not  realistic 
because  its  use  erroneously  assumes  requirements  can  be 
precisely  determined  before  system  construction  is 
attempted. 

The  prototyping  approach  is  considered  valid  because  it 
operates  on  the  more  realistic  assumption  that  precise 
requirements  are  not  always  definable  until  after 
construction  is  started.  They  assert  that  there  is  a  data 
life  cycle  distinct  from  the  traditional  systems  life  cycle. 
Further,  they  believe  the  degree  of  integration  of  systems 
is  a  function  of  how  much  data  are  shared  by  the  systems. 
From  these  concepts  it  is  the  job  of  the  prototyper  to 
discover  and  manage  the  integrating  data  in  the  most 
efficient  and  least  expensive  manner.  The  purpose  of  the 
data  driven  approach  is  to  develop  and  maintain  shared  data 
bases  (open  systems)  that  are  constantly  being  extended  to 
accommodate  new  information  requirements.  The  data  bases 
should  facilitate  the  extraction  and  synthesis  of  data  into 
useful  information  from  a  static  set  of  data  structures. 

Several  steps  are  required  to  apply  the  data  driven 
approach  to  a  particular  problem. 

1.  Operational  reviews  are  conducted  to  evaluate  the  "as 
is"  environment. 

2.  Conceptual  design  is  conducted  to  define  the  metadata 
structure  at  the  center  of  what  will  evolve. 

Scenarios  are  built  in  this  step  to  describe  those 
functions  for  changing  or  retrieving  the  metadata. 

The  metadata  is  normalized  in  the  data  design  phase 
where  the  physical  organization  of  the  data  is  built. 


3. 


4. 


Heuristic  analysis  then  follows  where  requirement 
scenarios  are  exercised  against  the  metadata 
structures  using  real  data  values. 

5.  Environmental  testing  is  conducted  where  programs  are 
built  to  support  data  acquisition  and  population  of 
the  data  bases. 

6.  Quality  control  is  applied  via  use  of  performance 
modeling  to  ensure  the  system  not  only  reflects  the 
user’s  desires  but  is  processing  in  a  realistic 
fashion. 

Proceeding  through  these  steps  requires  several  tools  such 
as  items  for  information  modeling,  activity  modeling, 
project  control,  a  relational  data  base  management  system 
and  a  data  dictionary.  [Ref.  26] 

G.  RELATION  BETREEN  PROTOTYPING  AND  DATA  DICTIONARIES 

The  increasing  complexity  of  computer  systems  and  the 
growing  demand  of  management  that  computer  systems  justify 
their  cost  and  support  decision-making  calls  for  an 
integrated  tool  that  is  capable  of  recording  and  processing 
information.  This  information  describes  both  the  structure 
and  usage  of  all  the  enterprise’s  data  and  functions.  A 
data  dictionary  is  a  tool  that,  if  integrated  with 
prototyping  and  the  traditional  methodologies,  can  meet  the 
demands  of  complex  systems  and  management  [Ref.  27]. 
Prototyping  has  proven  so  successful  that  some  computer 
service  companies  have  been  developing  packages  to  provide 
prototyping  off  the  shelf.  Most  of  these  packages  assume 
the  existence  of  a  fully  descr i ft ive  data  die lion ary  oi  else 
require  the  establishment  of  one  [Ref.  28].  Como  feel  that 
the  eventuality  of  extensive  networking  and  distributed 
processing  coupled  with  failure  to  properly  elicit  needs 
makes  it  imperative  that  data  dictionaries  be  integrated 
into  requirements  analysis  efforts  [Ref.  29]. 
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Figure  2.3  Integrating  Function  of  A  Data  Dictionary 


The  data  dictionary  that  results  from  requirements 
analysis  can  be  a  two-edged  sword.  It  can  become  both  a 
source  and  receptacle  for  the  prototyping  effort.  Without  a 
data  dictionary  of  some  type,  preferably  one  that  can  be 
used  as  an  adjunct  to  a  software  library,  the  analysis  task 
is  impossible.  The  dictionary  can  be  used  as  a  source  of 
information  necessary  for  prototyping  since  it  can  define 
entities,  attributes  and  relationships  at  a  conceptual 
level.  A  data  dictionary  can  contain  the  output  of 
prototyping  in  an  organized,  easy  to  manipulate  database 
instead  of  using  an  unwieldy  written  document  [Ref.  30].  In 
essence,  a  data  dictionary  should  be  at  the  center  of  the 
effort  and  serve  to  integrate  all  the  conceptual  output 
produced  by  the  tools  being  used. 
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III.  DATA  DICTIONARIES 


A.  DATA  CENTERED  SYSTEM  ANALYSIS 

An  understanding  of  the  role  data  dictionaries  play  in 
software  prototyping  first  requires  an  understanding  of  the 
underlying  philosophy  regarding  their  use.  Tnis  philosophy 
is  a  data  centered  view  of  system  analysis  as  opposed  to  a 
process  centered  approach. 

Data  centered  system  analysis  treats  the  data  as  a 
separate  resource.  Processes  are  still  considered 
important,  but  the  target  of  all  processing  activity  is 
data.  An  aspect  of  this  approach  is  a  perception  of  data 
processing  as  a  succession  of  changes  to  data.  A  process  is 
viewed  as  a  series  of  data  changes.  The  data  centered 
approach  contends  that,  in  the  long  run,  designing  a  stable, 
weli-uocumented  and  largely  nor.-r  edundant  structure  of  data 
provides  a  simpler  and  cleaner  fora  of  data  processing  than 
embedding  separately  designed  data  structures  into  many 
different  processes  or  applications  t.rograms. 

Several  advantages  accrue  from  the  data  centered 
approach.  The  data  centered  approach  helps  avoid  problems 
with  file  proliferation,  maintenance,  data  redundacy  and 
data  inconsistency.  Cnee  the  appropriate  data  bases  are  in 
place,  some  types  of  applications  can  be  created  guicKly 
with  high  level  data  base  languages.  Individual  users 
having  direct  access  to  the  data  bases  can  often  create 
their  own  reports  and  applications,  thus  avoiding  the  slow 
steps  of  formal  system  analysis.  Assembling  data  in 
different  ways  from  the  current  inventory  is  not  possible 
without  a  data  dictionary.  Data  administrators,  programmers 
and  users  cannot  realistically  be  expected  to  have 


sufficient  knowledge  of  the  logical  organization  of  data 
bases  to  readily  pick  and  choose  data  as  needed  to  derive 
applications. 

There  are  distinct  disadvantages  to  the  data  centered 
approach.  The  data  bases  used  oust  be  well  designed,  yet 
the  technology  of  good  data  base  design  is  often  not 
understood.  The  data  centered  approach  implies  the  sharing 
of  data  which  requires  different  management  from  that 
applied  to  a  collection  of  separate  files.  There  are 
conversion  problems  in  moving  from  the  traditional  process 
centered  to  the  data  centered  approach.  Some  of  these  are 
human  behavioral  problems  caused  by  users  losing  control  of 
data  they  previously  "owned".  The  cost  of  conversion  to  a 
data  base  environment  can  be  enormously  expensive.  The  data 
centered  approach  is  often  more  difficult  to  manage  in  its 
early  phases,  because  of  pressures  to  adopt  quick  alternate 
solutions  or  to  maintain  the  status  quo.  Once  set  up, 
however,  the  data  centered  approach  is  easier  to  manage  than 
a  process  centered  one.  Management  must  understand  these 
issues  clearly  for  the  approach  to  work. 

A  key  to  controlling  data  bases  and  facilitating  quick 
development  is  a  data  dictionary.  A  data  dictionary  can 
function  as  a  tool,  but  tools  should  not  get  in  the  way  of 
the  primary  goal:  solving  the  problem.  Any  tool  used  for 
requirements  analysis  must  contribute  to  managing  project 
complexity  rather  impeding  progress.  Capturing  the  data 
which  desribes  the  data  held  in  the  database,  the  metadata, 
must  be  a  smooth,  easy  process  which  does  not  burden  the 
momentum  of  discovery  built  in  working  with  users.  Users 
know  what  they  do  and  therefore  can  describe  processes  far 
easier  than  data.  Metadata  is  the  essence  of  the  means  of 
achieving  high  productivity,  shared  databases  and  reduction 
of  the  inefficiencies  associated  with  the  traditional 
development  process.  [Hef.  31] 


B.  METADATA 


Metadata  is  the  term  applied  to  that  data  which 
describes  other  data  or  databases.  Metadata  include 
descriptions  of  the  meaning  of  data  items,  the  ways  in  which 
the  data  are  used;  the  sources  of  particular  data  elements; 
the  physical  characteristics;  and  rules  or  restrictions  on 
their  forms  or  uses.  Some  choose  to  classify  metadata 
elements  into  3  types:  semantic,  physical  char acteristic, 
or  usage  information.  [Ref.  32] 

Semantic  information  is  comprised  of  the  names  of  the 
component  or  entities.  A  unique  identifier  should  be 
assigned  to  each  component  even  though  it  may  be  known  by 
other  names.  These  other  names  are  called  aliases.  The 
documenting  and  tracking  of  aliases  promotes  data  sharing 
across  applications.  The  prevalence  of  aliases  should  not 
be  encouraged  or  discouraged,  but  should  be  accepted  as  a 
fact  of  life.  End-users  call  things  by  different  names  and 
a  data  dictionary,  as  an  adjunct  to  the  database  which 
models  the  real  world,  should  accommodate  that  fact. 

Physical  characteristics  are  those  items  or  information 
which  describe  the  system  dependent  representation  of  the 
component.  The  length  in  bytes  of  a  data  element,  or  the 
access  method  for  a  particular  file  are  examples  of  physical 
characteristics.  This  category  includes  relationships  among 
systems  and  programs  which  use  the  database.  That  a 
particular  data  element  may  be  found  in  records  x,  y  and  z 
and  is  referred  to  by  programs  A  and  B  is  an  example  of 
physical  characteristic  metadata. 

Usage  information  illuminates  how  and  by  whom  data  are 
used.  This  type  of  information  enables  the  database 
administrator  to  trace  the  source  of  errors.  The  existence 
of  usage  information  also  permits  the  database  administrator 
to  assess  the  impact  of  changes  on  the  database  and  helps  to 


develop  structures  to  monitor  and  control  access.  If  the 
scope  of  a  data  dictionary  is  widened  to  include  usage 
information  then  it  must  include  data  about  users  and 
processes  as  well  as  data  about  data  elements.  Processes 
can  Le  performed  by  individuals,  organizations,  programs  or 
entire  systems.  A  process  can  be  a  single  transaction,  the 
generation  of  a  particular  item  such  as  a  report,  or  a  broad 
function  such  as  production  of  the  entire  monthly  payroll  to 
include  checks,  vouchers  and  a  summary  report  for 
management.  In  compiling  usage  information,  responsibility 
for  a  database  related  task  should  be  assigned  to  a 
particular  process  to  enable  monitoring  and  correction.  The 
source  of  a  transaction,  such  as  entering  the  number  of 
hours  worked  for  a  payroll  application,  should  be  documented 
and  traceable.  In  this  example,  a  clerk  may  be  used  to 
verify  and  enter  the  number  of  hours  worked.  [Bef.  33] 

Metadata  can  also  be  classified  as  one  of  three  types  of 
entities.  Entities  are  either  "real  world"  objects  or 
concepts  such  as  customers,  accounts,  salespersons  and 
orders.  Metaentities  can  be  classified  as  metadata 
entities,  metasystem  entities  and  meta-environment  entities. 
[Ref.  34] 

Entities  which  represent  data  objects,  such  as  data 
elements,  groups,  records,  files,  databases  or  reports  are 
examples  of  metadata  entities.  An  element  is  a  simple 
single  item  and  is  a  "primitive",  that  is,  it  cannot  be 
further  divided.  Elements  can  be  accumulated,  usually 
logically,  to  form  other  higher  level  metadata  entities  such 
as  groups  or  records.  A  savings  account  number  is  an 
example  of  a  data  element.  A  data  element  can  be  recursive, 
meaning  it  can  be  formed  or  conceived  as  consisting  of  other 
data  elements,  yet  for  purposes  of  the  particular 
application  cannot  be  further  subdivided.  A  savings  account 
number  may  be  separated  by  hyphens  when  printed  and  the 
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separated  parts  can  represent  different  meanings,  such  as 
branch,  type  account,  and  specific  customer.  However,  these 
different  numbers  will  always  be  carried  together  as  a 
singular  item.  [Bef.  35] 

Two  or  more  data  elements  can  he  collected  into  what  is 
called  a  group.  Groups  can  contain  other  groups.  The 
elements  or  groups  collected  to  form  a  group  are  usually 
logically  related  in  some  fashion.  Thus,  in  the  example  of 
an  address  group  the  elements  street,  city,  state  and  zip 
code  are  the  logically  related  elements  comprising  the 
group.  Groups  are  aggregations  larger  than  an  element  but 
smaller  than  a  record. 

A  record  is  a  collection  of  one  or  more  related  data 
elements  or  groups  that  is  treated  as  a  logical  unit.  Each 
employee  of  a  company,  for  example,  would  have  one  record 
and  it  would  be  a  collection  of  these  data  elements  and 
groups:  name,  department,  employee  number,  age  and  hone 
address.  [fief.  36] 

A  file  is  a  set  of  occurrences  of  records  treated  as  a 
unit.  Different  types  of  records  may  be  contained  within  a 
single  file,  or  it  can  contain  many  occurrences  of  a  single 
type.  An  occurrence  is  where  actual  values  nave  ueen 
assigned  to  the  fields  or  data  elements  of  a  record,  and  the 
record  therefore  now  models  the  reality  of  the  entity  on 
which  it  is  based.  [Bef.  37] 

A  database  is  an  aggregation  of  DBMS  files,  records, 
groups  and  elements.  Databases  vary  in  both  logical  and 
physical  organization  depending  on  the  data  model  used  to 
design  the  database  and  the  DBMS  used  to  implement  the 
database.  [Bef.  38] 

Reports  ace  aiso  classified  as  metadata  entities 
although,  unlike  any  of  the  previously  discussed  entities, 
reports  are  usually  not  stored  but  produced  on  execution  of 
a  subsystem  or  program.  A  report  is  a  formatted 
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representation  of  information,  not  data.  Data  is 
manipulated  and  given  meaning  when  a  report  is  produced. 
Data  items  are  facts  which,  without  manipulation  and 
association  with  other  facts,  have  no  meaning  to  humans. 
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File 

Reco  rd 

Group 

Data  element 

_ 

Figure  3.1  Hierarch;  of  Metadata  Entities 

Systems,  programs,  subroutines,  and  modules  are  all 
examples  of  metasystem  entities.  This  class  of 
metaentities  represents  processes  of  the  data  processing 
environment.  [Ref.  39] 

A  system  is  a  collection  of  related  programs  or  systems 
which  together  perform  a  set  of  functions  for  some  general 
purpose.  For  example,  a  payroll  system  might  consist  of 
many  programs:  one  for  producing  checks,  one  for  updating 
an  employee  database,  and  one  fcr  producing  a  summary 
report. 

A  program  is  a  collection  of  source  code  statements  (in 
assembly,  compiler,  yuery  or  fourth  generation  language) 
that  accomplishes  one  or  more  actions.  Programs  contain  one 
or  more  modules. 
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A  module  is  a  collection  of  executable  statements  which 
exists  to  accomplish  one  specific  application  function. 
Modules  are  the  result  of  software  being  divided  into 
separately  addressable  collections  of  source  language 
statements.  Modules  can  be  categorized  in  one  of  three  ways 
[Ref.  40]  : 

1.  Sequential  types  which  are  referenced  and  executed 
without  interruption  of  the  application  software. 

2.  Incremental  types  which  can  be  interrupted  before 
completion  and  restarted  at  the  point  of 
interruption. 

3.  Parallel  types  which  execute  simultaneously  with 
another  module  in  a  multiprocessor  environment. 

A  transaction  is  any  event  that  requires  the  database 
information  to  be  accessed.  Transactions  are  characterized 
by  type  (batch  or  on-line),  frequency  (i.e.  number  of  times 
per  month)  ,  and  use  (add,  delete,  modify)  .  Transactions  are 
usually  thought  of  as  manual  actions  taken  by  a  user  which 
result  in  actions  being  taken  by  the  software  system. 

Interfaces  are  places  at  which  independent  modules, 
programs,  or  systems  meet  and  either  act  on  or  communicate 
with  each  other.  Interfaces  can  be  hardware,  software,  human 
or  procedural  components  of  a  system.  Most  often  there  is  a 
transfer  of  data  across  an  interface  which  must  be  clearly 
understood.  An  interface  description  should  provide  a  list 
of  all  data  that  enters  and  exits  a  component.  For  a  single 
module  the  description  should  indicate  what  data  moves 
across  an  argument  list,  any  external  world  input/output 
information  that  is  used  and  information  acquired  from 
global  data  items.  An  example  cf  an  interface  description 
for  a  module  which  calculates  the  miles  per  gallon  being 
used  by  a  digital  automobile  dashboard  system  would  look  as 
follows  [Ref.  41]  : 

Calling  protocol:  CALL  CALC-MFG  (MPH,G  PH,  MPG) 

where 


36 


MPH  is  miles  per  gallon  ( rea 1, in  put) 

GPH  is  gallons  per  hour  (real,  input) 

MPG  is  miles  per  gallon  (real,  output) 

No  external  I/O  or  global  data  are  used 
CALLED  BY:  DATA-CONV-C TL 
CALLS:  no  subordinates 

The  environment  constitutes  another  category  of 
meta-entities.  This  category  can  be  divided  into  many 
different  items  if  it  is  desired  that  the  system  track  the 
equipment  configuration  as  well  as  the  data.  If  not,  then 
the  category  of  physical  devices  is  sufficiently  descriptive 
and  refers  to  such  items  as  a  CET  terminal,  printer,  disk 
drive,  etc.  [Hef.  42] 

An  important  aspect  of  gathering  and  analyzing  metadata 
is  describing  it.  Descriptive  adjectives,  categories  and 
properties  of  an  entity  are  called  attributes.  Plagman  and 
Leong-Heong  cite  eight  generic  categories  of  meta-entity 
attributes: 

1.  Identification  attributes  which  designate,  describe 
or  somehow  identify  the  entity.  Entities  may  be 
known  by  more  than  one  name  depending  on  the  time, 
place  and  user’s  frame  of  reference. 

2.  Relationship  attributes  denote  associations  between 
two  meta-entities.  For  example,  one  entity  may  be 
used  by  another.  Relationship  attributes  are 
sometimes  similar  to  interfaces.  A  link,  subroutine 
call,  access  path  or  mapping  qualify  as  a 
relationship  type  attribute. 

3.  Representation  attributes  describe  an  entity  as  it  is 
implemented.  A  data  element  is  represented  in  terms 
of  character  (alphabetic,  numeric  or  mixed),  source, 
or  length. 
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Statistical  attributes  are  numerical  descriptions 
such  as  frequency,  estimated  life,  and  usage.  This 
class  of  attributes  are  useful  to  the  Database 
Administrator  in  assessing  the  impact  of  changes  and 
for  optimizing  queries. 

5.  Physical  attributes  help  describe  environmental  and 
system  entities.  Examples  are  storage  media,  storage 
size,  terminals  and  CPU  model. 

6.  User-defined  attributes  are  those  things  about  a 
particular  application  such  as  the  users,  analysts, 
designers,  customers,  etc.  that  are  helpful.  A 
"free-form"  attribute  is  included  in  this  category. 
This  is  often  implemented  as  a  comment  field  but  can 
be  specifically  named  if  the  user  desires. 

7.  Control  attributes  are  descriptors  for  how  restraint 
over  an  entity  is  exercised  such  as  security 
classification  or  edit  criteria. 

8.  Status  attributes  provide  the  life  cycle  status  of 
the  entity;  e.g.  candidate,  test,  operational, 
deleted  or  archived  [Bef.  43], 

a)  A  test  status  means  the  entity  can  be  modified 
with  approval  of  someone  in  project  management.  A 
test  entity  is  not  for  production  runs  or  general 
use. 

b)  An  item  categorized  as  operational  is  being  used 
by  the  system  on  a  regular  basis.  Modification  of 
the  item,  especially  in  a  file  oriented  (as 
opposed  to  a  DBMS  oriented)  environment,  may  cause 
problems  and  therefore  is  carefully  controlled. 

c)  Archived  means  the  item  is  no  longer  used 
operationally  anywhere  in  tne  automated  components 
of  the  system.  "Old  timers"  may  still  refer  to 
archived  entities  and,  therefore,  such  items 
should  be  available  for  reference,  but  not  for 


use. 
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Record 
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Computer  system 

Group 
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File 
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Line 

Database 

Transaction 
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Function 

Indicating  the  status  of  a  meta-entity  is  important  for 
the  purposes  of  project  and  configuration  management.  It  is 
important  to  know  whether  a  simple  data  element,  a  program 
or  an  entire  system  is  either  under  development,  being 
integrated  or  operational. 

It  is  obvious  from  this  discussion  that  the  task  of 
managing  metadata  can  be  as  challenging  as  managing  the 
user's  data.  Consequently,  the  same  tecnniaues  can  be  used 
to  manage  metadata,  that  is,  organizing  it  into  a  database, 
the  data  dictionary. 
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C.  DEF INITIOS  1ID  OBJECTIVES  OF  A  DATA  DICTIONARY 


Familiarity  with  what  constitutes  a  data  dictionary  and 
the  purpose  far  having  one  are  requisite  for  later 
understanding  of  its  role  in  requirements  analysis.  The 
need  for  documenting  data  is  obvious  and  grows  from  the 
universally  recognized  need  to  document  the  two  primary 
components  of  any  software  system,  functions  and  data.  A 
data  dictionary  is  a  repository  of  data  about  data  and 
processes  associated  with  a  particular  systems  development 
effort.  A  dictionary  often  includes  a  glossary  of  terms, 
data  characteristics,  process  descriptions,  and  some 
cross-referencing  mechanism. 

Data  dictionaries  come  in  three  different  forms. 

1.  The  data  documentation  for  a  system  can  be  made  a 
part  of  either  the  requirements  specification  or  a 
design  document. 

2.  A  data  dictionary  can  exist  as  a  separate  printed 
document. 

3.  A  data  dictionary  can  be  an  automated  data  base. 

Data  dictionaries  can  be  expanded  to  include  information 
about  the  physical  location  of  the  data.  In  that  case  it 
becomes  a  data  dictionary/directory.  If  either  the  data 
dictionary  or  data  dictionary/directory  uses  software  to 
store  and  access  the  data,  it  is  considered  a  system.  The 
following  delineates  feasible  manifestations  of  a 
diet  ionary : 

1.  A  data  dictionary  is  a  repository  for  data  about  data 
and  functions. 

2.  A  data  dictionary  system  is  a  software  system  to 
store  and  access  data  about  data  and  functions. 

3.  A  data  dicticnary/direc tory  is  a  repository  about 
both  logical  and  physical  information  for  data  and 
functions. 
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A  data  dictionary/directory  system  is  a  software 
system  to  store  and  access  both  logical  and  physical 
information  about  data  and  functions. 

Several  criteria  are  worth  examining  in  deciding  which 
way  to  document  data.  These  are: 

1.  Estimated  size  and  complexity  of  the  system. 

2.  Extent  of  sharing  of  data  between  systems. 

3.  Use  of  a  generalized  DBMS. 

4.  Availability  of  automated  data  dictionary  software. 

5.  Number  of  data  descriptions. 

6.  Complexity  of  data  structures. 

7.  Volatility  of  data  descriptions. 

8.  Number  of  analysts  and  programmers  involved. 

9.  Number  of  organizations  involved. 

10.  Amount  of  clerical  assistance  available. 

11.  Uses  of  the  data  documentation. 

The  greater  the  number  and  strength  of  these  factors,  the 
earlier  a  decision  must  be  made  about  which  means  to  docu¬ 
ment  data,  and  the  stronger  the  probability  that  that  means 
will  be  an  automated  system.  Regardless  of  form  a  data 
dictionary  should  document  several  different  components. 

All  files,  record  types,  items  within  records  and 
pertinent  information  about  the  use  of  the  data  should  be 
included  in  the  data  dictionary.  Pertinent  information 
includes  such  items  as  physical  description,  logical 
description,  and  functional  description  of  how  the  data  is 
used.  Further,  it  elaborates  on  how  the  data  is  changed, 
how  it  is  removed,  and  how  integrity  is  ensured. 

Based  on  the  information  the  dictionary  holds,  it  may 
satisfy  many  objectives  [Bef.  44].  Generally  any  data 
dictionary  should  provide  facilities  and  formats  for 
documenting  the  information  collected  during  all  stages; 
analysis,  design  and  implementation.  Further,  it  snouid 


help  the  analysts  follow  any  of  the  structured  methodologies 
available  for  system  development.  Data  descriptions,  not 
only  processes,  should  be  traceable  back  through  program 
functions  to  the  original  statement  of  requirements.  The 
dictionary  should  be  readily  extensible  to  accommodate 
growth  or  expanded  application.  Its  existence  should  help 
achieve  the  establishment  of  a  glossary  of  terms  and  thus 
provide  for  standard  terminology.  Analysis  can  be 
accomplished  using  the  proper  terms  in  the  proper  context 
in  dealing  with  the  user’s  particular  application  area. 
Semantics  are  important  for  both  understanding  the  user's 
area  and  for  tailoring  the  system  to  his  frame  of  reference. 
Modules  which  are  available  to  all  systems  should  be 
identified  via  a  generic  cross-ref erence  capability. 

Going  beyond  the  analysis  phase,  the  dictionary  can 
provide  assistance  in  generating  manageable  and  complete 
test  data.  Problems  which  arise  associated  with  aliases  and 
acronyms  can  be  resolved  via  a  data  dictionary.  As  an 
adjunct  to  configuration  management,  a  dictionary  provides 
centralized  control  for  system  changes.  Again  going  beyond 
the  analysis  phase,  a  dictionary  can  serve  as  a  reference 
and  guide  in  training  users  and  for  design  evolution. 
Maintenance  efforts  can  be  assisted  in  a  similar  vein  in 
that  programmers  unfamiliar  with  specifics  can  refer  to  the 
dictionary  as  a  guide. 

Having  met  a  majority  of  these  objectives,  a  dictionary 
should  be  capable  of  answering  several  questions  [fief.  45  ]# 
[Ref.  46]. 

1.  What  kind  of  validity  tests  have  been  applied  to  this 
data  type? 

2.  Who  is  authorized  to  update  this  data  item? 

3.  What  modules,  programs  or  systems  use  this  data  type? 

4.  What  are  the  valid  ranges  of  values  for  this  data? 
(domain) 


5.  What  security  level  is  applied  to  this  item? 

6.  Who  is  allowed  access  to  the  data? 

7.  By  what  other  names  is  the  data  type  known  in  various 
application  environments?  (the  differences  should  be 
minimized) 

8.  In  what  reports  does  this  data  type  appear? 

9.  What  is  the  input  source  for  this  data  type? 

10.  What  are  all  the  data  items  used  by  a  given  program 
or  report? 

Data  dictionaries  may  have  problems,  particularly  if 
they  are  not  well  organized.  If  a  dictionary  is  fully  used, 
meaning  that  if  it  is  an  active  dictionary  which  serves  a 
controlling  function,  then  it  becomes  a  centralized 
controlling  facility.  Centralized  control  of  data  is  not 
always  desirarable  or  appropriate.  For  a  data  dictionary  to 
get  to  this  point,  considerable  effort  must  be  expended. 
Therein  lies  another  problem  in  that  development  and 
implementation,  to  be  useful,  requires  careful  thought  and 
considerable  effort  [Bef.  47].  Another  problem  is  the  lack 
of  a  methodology  which  ties  the  use  of  a  dictionary  into  the 
overall  system  development  effort.  Dictionaries  need  to  be 
able  to  support  and  measure  the  documentation  progress. 

Dnf ortunately  the  means  of  describing  primitive  entities  in 
different  commercial  data  dictionary  packages  is  dissimilar. 
Few  dictionaries  have  specific  provisions  for  supporting  a 
structured  analysis  technique  [Bef.  48].  Features  which  are 
important  for  database  design,  but  absent  from  many  current 
products  are  support  for  distinguishing  between  a  data 
element  and  its  domain  and  the  lack  of  a  graphic 
representation  capability.  In  response  to  these  problems 
this  thesis  proposes  that  a  model  that  is  easily  understood, 
the  relational,  be  used  to  organize  a  data  dictionary. 


The  relational  model  is  appropriate  for  protoyping  with 
data  dictionaries  for  several  reasons.  As  discussed 
earlier,  the  ease  of  use,  availability  of  query  language  and 
data  independence  make  relational-based  DBMS  good  tools  for 
prototyping.  The  relational  model  is  good  for  data 
dictionary  implementation  because  many  relational  DBMS  have 
a  "triggering"  mechanism  causing  a  program  to  be  invoked  on 
some  data  event  or  condition.  This  is  an  essential  feature 
for  a  data  dictionary  to  be  active,  that  is,  to  serve  as  a 
monitor  of  database  activity  to  ensure  data  integrity.  An 
additional  advantage  is  the  schemas  of  relational  systems 
are  tables.  This  can  reduce  the  work  required  to  implement 
the  dictionary  system.  For  these  reasons,  and  because 
relational  DBMS  are  now  available  for  microcomputers,  a 
prototype  data  dictionary  has  been  developed  and  is 
described  in  the  next  chapter. 
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IV.  A  fiiT4  DICTIONARY  BASED  ON  THE  B ELATION A L  MODEL 


A.  INTRODUCTION 

The  office  of  the  Deputy  Chief  of  Staff  for  Plans 
(DCSPLANS)  ,  the  OS  Army  Military  Personnel  Center 
(MILPERCEN) ,  has  the  responsibility  to  develop  and  maintain 
computer  based  modelling  capabilities  to  support  personnel 
policy  development  for  the  Army.  DCSPLANS  has  subordinate 
branches  each  of  which  uses  and/or  maintains  models.  In  a 
prototype  effort  to  assist  DCSPLANS  organize  and  account  for 
these  information  resources,  a  relational  dictionary  system 
was  developed  using  the  dBase  II  relational  DBMS. 

The  prototype  system  is  capable  of  running  on  an  IBM 
Personal  Computer.  A  relational  based  DBMS  was  used  because 
of  the  features  previously  discussed.  A  microcomputer- based 
version  was  used  to  facilitate  transfer  of  the  prototype 
from  the  development  site  at  the  Naval  Postgraduate  School 
to  MILPERCEN  at  Alexandria,  VA. 

The  dictionary  accounts  for  several  different  relations 
including  reports,  offices,  models,  programs,  files, 
elements  (which  are  partitions  of  files,  rather  than  data 
elements)  and  fields.  The  generalized  format  of  these 
relations  is  as  follows: 

REPORT  (  rname,  full_name,  number,  status,  sec_class, 
output_format,  purpose,  description,  perdiodicit y) 

OFFICE  (  ofc,  oname,  bldg,  room,  phone,  comments,  poc) 

MODEL  (  mdl,  model_name,  methodology,  status,  location, 
purpose,  description,  runame,  perdiodicity ) 


PROGRAM  (  pname.  version,  location,  language,  purpose, 
description,  status,  perdiodicity) 

FILE  (  f name.  full_name,  last_update,  media,  status, 
sec_class,  purpose,  description,  poc) 

ELEMENT  (  elname,  version,  date,  seg_num,  size,  poc,  purpose, 
location) 

FIELD  (  fid,  length,  data_type,  null_status,  source,  domain, 
description,  purpose,  status,  sec_class,  poc) 

For  a  detailed  explanation  of  the  attributes  for  these 
relations,  see  Appendix  B,  Data  Dictionary  Data  Elements. 

Relationships  amongst  the  various  relations  are  tracked 
by  having  relations  with  a  verb  name  reflecting  how  one 
entity  relates  to  another.  For  example,  since  a  MODEL  may 
be  used  by  many  different  OFFICES,  a  USES  relation  is 
included  in  the  dictionary.  Its  format  is  as  follows: 

OSES  {  ofc,  ename,  etype)  .  An  example  occurrence  of  this 
relation  would  be: 

USES (DAPC-PLF,  P3M ,  MODEL) 

which  states  that  the  office  DAEC-PLF  uses  the  P 3M  model. 

There  are  six  of  these  verb  type  relations.  In  addition  to 
the  OSES  relation  these  are  CONTAINS,  MAINTAINS,  OUTPUTS, 
INPUTS,  and  CALLS.  The  generalized  format  of  each  of  these 
is  as  follows: 

CONTAINS  (  enamel  .  et  ypel .  ename,  etype) 

MAINTAINS  (  ofc,  mdl,  model_poc) 

OUTPUTS  {  enamel,  etv  pel .  ename,  etype) 

INPUTS  {  enamel .  etypel,  ename,  etype) 

CALLS  (  enamel .  ety pel,  ename,  etype) 


The  attribute  ename  stands  for  entity  name  and  the  attribute 
entity  type  stands  for  entity  type.  In  general,  these 
attributes  can  be  instantiated  ly  any  entity  (e. g.  model, 
program,  file,  element,  etc.)  The  specific  relationships 
these  relations  track  (see  Figure  4.1)  are  as  follows: 

1.  An  OFFICE  uses  many  different  REPORTS. 

2.  An  OFFICE  uses  or  maintains  many  MODELS. 

3.  A  MODEL  is  used  or  maintained  by  many  different 
OFFICES. 

4.  A  MODEL  calls  many  different  PROGRAMS. 

5.  A  MODEL  outputs  many  different  FILES. 

6.  A  MODEL  inputs  many  different  FILES,  i.e.  requires 
many  different  FILES  as  inputs. 

7.  A  MODEL  outputs  many  different  REPORTS. 

8.  A  FILE  contains  many  different  ELEMENTS. 

9.  An  ELEMENT  contains  many  different  FIELDS. 

10.  A  FIELD  is  contained  by  many  different  ELEMENTS. 

There  are  two  special  relations  which  are  neither  pure 

entities  nor  verb  descriptors.  These  are  ALIAS  and 
CATEGORY. 

The  ALIAS  relation  provides  a  means  of  tracking  entities 
by  all  known  names.  Often  an  entity  is  given  one  or  more 
names  other  than  that  by  which  it's  officially  known.  For 
the  users  the  other  name,  the  alias,  is  the  natural  way  of 
referring  to  the  entity  and  therefore  the  dictionary  should 
accomodate  that.  The  Personnel  Policy  Projection  Model 
being  called  "Pimmy"  is  an  example  of  an  alias. 

The  CATEGORY  relation  provides  the  basis  for  Key  Word  In 
Context  (KWIC)  capability.  Further,  it  allows  the  user  to 
categorize  different  types  of  entities  and  relate  them  in  an 
ad-hoc  fashion.  For  example,  if  several  files  and  programs 
were  the  responsibility  of  a  particular  programmer  to  audit, 
all  those  different  entities  could  be  entered  as  category 
records  with  that  programmer's  name  as  the  particular 
category. 
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The  format  of  the  ALIAS  and  CATEGORY  relations  is  as 
follows: 

ALIAS  (  ename.  ety£e,  aname) 

CATEGORY  (  ename,  ety£e,  cat) 


REPORT 


PROGRAM 


« - >>)  OFFICE 


MODEL  «- 


T 


T 

V 


J  FILE  J 

”T~ 


ELEMENT 

~r 

7 


FIELD 


Figure  4. 1  Bachman  Diagram  of  Entities 

Structuring  the  metadata  as  shown  above  offers 
advantages  for  ease  of  learning  and  using  the  data 
dictionary.  The  logical  structure  is  based  on  a 
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commercially  successful  data  dictionary  system,  DataManager. 
The  data  dictionary  is  a  database  and  therefore  models  the 
real  world  in  a  limited  fashion.  By  taking  a  data-centered 
viewpoint  wherein  all  entities  are  categorized  as  either 
objects  (i.e.  models  or  reports),  or  processes  (i.e.  uses, 
contains,  maintains)  which  act  on  objects,  an 
easy-to-understand  model  emerges.  Consequently,  use  of  the 
dictionary  is  facilitated  so  that  it  becomes  a  tool,  rather 
than  a  burden  to  the  data  system  developer /maintainer/user. 
This  will  be  substantiated  by  the  following  discussion  of 
the  system  structure  and  query/report  capabilities. 

B.  SYSTEM  STHOCTUBE  1*D  OSEB  I HTERFACE 

The  software  of  the  system  was  structured  to  provide  all 
the  possible  functions  one  might  wish  in  a  database  system. 
These  are  the  ability  to  add,  change,  or  delete  records  and 
to  provide  reports  and  queries  (see  Figure  4.2)  .  Because 
the  system  is  a  prototype  and  specific  user  needs  are 
unknown,  all  functions  are  provided.  Depending  on  user 
feedback  and  observations  made  by  the  analyst,  these 
functions  can  be  expanded  to  offer  different  dialogues  or  be 
converted  to  batch  procedures. 

The  user  interface  for  any  interactive  system  is  an 
important  criterion  for  success.  Because  a  data  dictionary 
system  should  be  a  tool  to  facilitate  software  system 
development  and  maintenance,  it  should  provide  a  friendly 
user  interface.  This  data  dictionary  system  is  menu  and 
prompt  driven.  The  software  prompts  for  all  necessary  data 
and  actions  to  develop  and  maintain  intersection  records 
(in  this  system  called  processes  "r  verbal  relations  such  as 
CONTAINS  or  USES).  Consequently  the  user  manual  for  the 
system  is  not  a  long  and  trying  document  to  use. 
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MAIN  MENU 


ADD 

MENU 


CHANGE 

MENU 


DELETE 

MENU 


OLRY 

ENU 


REPORT 

MENU 


-model 

-office 

-report 

-program 

-file 

-element 

-field 

-alias 

-category 


chg- model 
chg-office 
chg- report 
chg- program 
chg-file 
chg- element 
chg- field 
chg-alias 
chg-category 


del-model 

d  el-office 

del-report 

del-program 

del-file 

del-elemen  t 

del-field 

del-alias 

del-category 


fortrev  sumod 
baktrev  sumrep 
foral  sumfil 
bakal  sumoff 
forcat  sumrep 
bakcat 


Figure  4.2  Hierarchical  Chart  of  Software 


The  query  interface  is  particularly  friendly.  The 
system,  named  dDICT  II,  provides  two  types  of  queries, 
forward  and  backward.  Forward  means  the  user  is  presented 
columns  of  relations  from  which  to  pick.  The  columns, 
following  the  forward  flow  of  the  English  language,  are 
subject,  verb  and  objects.  The  user  provides  the  unique 
name  of  an  entity  beside  its  type  in  the  subject  column; 
marks  1  appropriate  verb  column  and  1  appropriate  object 
column.  For  example,  to  answer  the  question  "What  models 
does  the  office  with  symbol  DAPC-PLF  use  ?"  the  Figure  4.3 
depicts  how  the  screen  of  the  FCRTBEV  proqram  would  appear. 
The  Figure  4.4  depicts  how  output  from  this  query  would 
appear.  Verb  and  object  choices  must  be  appropriate  for  the 
subject  in  that  it  is  not  possible  to  get  any  response  from 
a  query  marked  for  which  there  is  no  relationship  defined. 
For  example,  marking  the  screen  of  the  FORTREV  program  to 
answer  the  question  "What  models  contain  what  fields  ?  " 
would  elicit  no  response  when  processed. 


SUBJECTS 


VEB3S 


OBJECTS 


0  f f ice: DAPC-P  LF  : 

Uses :  X: 

Reports: 

Maintains:  : 

Models: X 

Model:  : 

Calls:  : 

Programs; 

Inputs:  : 
Outputs:  : 

Files: 

File: 

Contains:  : 

Elements: 

Element:  : 

Fields: 

To  quit  put  an  X 

in  this  field  :  : 

Put  the  unique  name  of  the  entity  you  are  querying  about 
in  the  field  next  to  the  entity's  type.  Then  place  an  X 
in  one  appropriate  verb  field  for  that  entity  type  and 
an  X  in  1  appropriate  object  field. 

I.E.  Of f ice: D APC-PLF  :  Uses:X:  Moiels:X: 

To  process  query  move  cursor  tnrough  remaining 
fields  using  RETURN  key. 


Figure  4.3  Example  of  a  Forward  Retrieval 
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The  office  DAPC-PLF  uses  the  following  models 

P3M 

OAS 

Strike  any  key  to  continue. .  . 

WAITING 


Figure  4.4  Sample  Output  From  a  Forward  Retrieval 


The  backwards  approach  is  implemented  by  presenting 
from  left  to  right  columns  of  objects,  verbs  and  then 
subjects.  Thus,  to  answer  a  question  such  as  "What  offices 
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use  the  P3M  model  ?"  see  Figure  4.  5  for  how  the  the  screen 
of  the  BAKTREV  program  would  be  marked.  This  guery  will 
produce  the  unigue  names  of  the  offices  that  use  the  P3M 
Model  and  Figure  4.6  shows  how  the  output  would  appear. 


OBJECTS 


VERBS 


SUBJECTS 


Model: P3M 
Report: 


Is  used  by:X; 
Is  maintained  by:  : 


D  f f ice: X : 


Program: 

File: 


Is  called  by: 
Is  inputted  by: 
Is  outputted  by: 


Model : 


Is  contained  in: 


Element: 

Field:  : 

To  quit  put  an  X  in  this  field: 


File: 

Element: 


Enter  the  name  of  the  entity  besides  its  type  and  then 
mark  1  verb  field  and  1  subject  field.  To  process 
query  move  cursor  down  through  remaining  fields 
using  RETURN  key. 


Figure  4.5  Example  of  a  Backward  Retrieval 


Because  the  ALIAS  and  CATEGCRY  relations  are  each  a 
special  case,  they  are  given  their  own  respective  forward 
(FORAL  &  FORCAT)  and  backward  (EAKAL  &  3AKCAT)  guery 
programs.  For  example,  if  you  wish  to  know  all  the  aliases 
that  exist  for  all  models  in  dDICT  II  you  would  execute  the 
FORAL  program  and  mark  the  menu  as  in  Figure  4.7  and  Figure 
4.8  shows  how  the  output  would  appear. 

If  you  wish  to  know  all  aliases  for  an  entity  for  which 
you  knew  the  name  you  would  use  the  BAKAL  guery.  For 
example,  if  you  wanted  to  know  all  the  aliases  for  the  P3M 


The  model  P3M 


is  used  by  the  following  offices 


DAPC-PLP 

DAPC-PLT 

DAPC-PLS 

DAPC-PIF 

Strike  any  key  to  continue  .  .. 
WAITING 


Figure  4.6  Output  From  a  Backwards  Retrieval 


i - 1 

Model:X:  File:  : 

Program:  :  Element:  : 

Report:  :  Field:  : 

Enter  an  X  in  the  field  beside  the  type  of  entitv 
for  which  you  want  all  names  and  aliases.  Mark  only  1 
field. 


Figure  4.7  Example  of  FOfiAL  Menu 

model  you  would  mark  the  menu  of  the  3AKAL  query  as  in 
Figure  4.9  and  Figure  4.10  shows  how  the  output  from  that 
query  would  appear. 

The  FOP.CAT  program  permits  you  to  determine  all 
occurrences  of  a  type  of  entity  and  in  what  category  each 
occurence  falls.  For  example,  if  you  wish  to  know  what 
models  had  been  categorized  in  some  way  see  Figure  4.11  fo 
how  to  mark  the  menu  of  the  FOECAT  program.  Figure  4.12 
depicts  how  the  output  would  appear.  See  Figures  4.13 
and  4.14  regarding  use  of  the  3AKCAT  program. 


The  following  models  have  the  associated  aliases 

P3M  PIMMY 

P3M  PAIN 

OAS  ASSETER 

Strike  any  key  to  continue  - .. 

WAITING 


Figure  4.8  Example  of  Output  From  FOBAL  Query 


— 

1 

Model: P3M  : 

File: 

I 

Program: 

:  Element: 

z 

Report: 

:  Field: 

• 

Enter  the  name  of 
beside  its  type. 

the  entity  in  the  field 
Provide  only  1  name. 

Figure  4.9  Example  of  BAKAL  Program 


The  model  P3M  has  the  following  aliases 

PINMY 

PAIN 

Strike  any  key  to  continue  .  .. 

WAITING 


Figure  4.10  Example  of  Output  from  BAKAL 
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Model:X:  File:  : 

Program:  :  Element:  : 

Report:  :  Field:  : 

Enter  an  X  in  the  field  besides  the  type  of 
entity  for  which  you  want  all  names  ana  associated 
category.  Mark  only  1  field. 


Figure  4.11  Example  of  Menu  for  FORCAT  Program 
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The  following  models  are  in  the  associated  category 

OAS  OFFICER 

Strike  anv  key  to  continue  .  .. 

WAITING  * 


Figure  4.12  Example  of  Output  From  FORCAT 

For  more  extensive  information  about  a  particular  Model, 
File,  Office,  or  Report,  the  Report  subsystem  exists.  This 
subsystem  has  a  menu  from  which  the  user  selects  the  type  of 
report  program  to  execute.  The  system  will  then  prompt  the 
user  for  the  unique  name  of  an  entity.  From  that  the  system 
will  then  provide  a  printed  summary  report  which  provides 
all  entities  which  have  a  direct  relationship  with  the 
entity  named.  Thus,  if  the  user  provides  the  unique  name  of 
a  Model,  the  printed  report  would  list: 

1.  All  offices  which  use  the  Model. 
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Model: OAS  : 

File:  : 

Program: 

:  Element:  : 

Report:  : 

Field:  : 

Enter  the  name  of  the 
type.  Provide  only  1 

entity  in  the  field  beside  its 
name. 

. 

The  model  OAS  is  in  the  associated  category 
OFFICER 

Strike  any  key  to  continue 
WAITING 


Figure  4.  14  Example  of  Output  for  BAKCAT  Program 

2.  All  offices  which  maintain  the  Model. 

3.  All  programs  the  Model  calls. 

4.  All  reports  the  Model  outputs. 

5.  All  files  the  Model  either  inputs  from  or  outputs  to. 

For  example,  if  you  wished  to  have  a  summary  report  for  the 

P3 M  model  you  would  select  option  1  from  the  Reports  menu 

for  execution  of  the  SUMOD  program.  The  system  would  then 

prompt  you  as  follows: 

Please  enter  the  unigue  name  of  the  Model 
Hit  the  space  bar  and  RETORN  to  guit:P3M 

Figure  4.15  shows  how  the  output  would  appear. 


The  Model  P3  M 

Is  used  by  the  following  offices: 

DAPC-P1P 

DAPC-PLT 

DAPC-PLS 

DAPC-PLF 

Is  maintained  by  the  following  offices  with 
the  point  of  contact; 


DAPC-PLF  KALINICH 

Inputs  the  following  files: 

P3MDATA 

Outputs  to  the  following  files: 
P3M0UTPUT1 

Outputs  the  following  reports: 

EPMR 

P3MHEP1 

Calls  the  following  programs 

P3UPE0GUN01 

P3MPROGDOS1 

P3MPHCGTBES1 


Strike  any  key  to  continue 
WAITING 


Figure  4. 15  Example  of  Report  Output 

Providing  these  query  and  report  capabilites  makes  the 
dictionary  more  than  a  repository  but  a  fully  capable  tool. 
Dse  of  the  dictionary  to  manage  data  is  not  merely  made 
possible  but  truly  facilitated.  The  data  administrator  can 
quickly  input  or  retrieve  metadata  as  appropriate  to  impose 
order,  control  and  effective  management  of  a  critical  part 
of  the  organization’s  resources.  Implementation  and  use  of 
a  dictionary  marks  an  important  step  in  an  organization 
towards  knowing  what  data  assets  it  has  and  most 
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importantly,  what  data  assets  it  needs.  Needs  are 
requirements  the  specification  of  which  must  be  precise  to 
be  impleaentable.  For  example,  knowing  exactly  what  fields 
occur  in  what  elements  and,  therefore,  what  else  we  need  to 
accomplish  some  function  is  a  critical  question  to  be 
answered  in  defining  requirements.  Having  an  automated  and 
interactive  means  of  answering  such  questions  provides  a 
decided  advantage  over  using  textual  documents.  This 
dictionary  thus  provides  an  important  tool  from  which  the 
data  administrator  can  more  expeditiously  manage  the 
organization* s  current  data  processing  capabilities. 

Because  the  user  of  this  dictionary  is  located  across 
the  country  from  the  development  site,  a  demonstration 
version  of  the  dictionary  was  created  and  populated  with 
example  data  (see  Figures  4.16  and  4.17).  The  demonstration 
version  can  be  used  to  learn  the  capabilities  of  the  system 
without  fear  of  destroying  anything.  Once  confident  with  the 
operation  of  the  demonstration  version,  the  user  can  migrate 
to  the  production  version. 

Because  dDICT  II  is  a  prototype  it  is  missing  features  a 
refined  and  full  production  system  would  have.  Host 
importantly,  the  software  doesn’t  enforce  relational 
constraints.  Thus,  seme  entities  can  be  present  without 
others  also  being  present.  For  example,  a  program  can  exist 
without  there  also  existing  a  model  which  calls  that 
program.  It  remains  to  be  determined  how  important  it  is 
for  metadata  integrity  to  have  the  software  enforce 
relational  constraints.  Further,  dDICT  II  does  not  enforce 
what  can  be  entered  for  a  particular  attribute  of  an  entity. 
Because  many  of  the  attributes  contain  narrative  text  it  is 
not  possible  to  develop  precise  logic  for  what  can  and 
cannot  be  entered.  However,  this  is  a  refinement  which 
should  be  added  once  the  user  has  migrated  to  the  production 
version  and  populated  it  with  real  metadata.  The  attributes 
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Model:  O&S 


Reports:  OPMR,  OASREP1 
Users:  DAPC-OPD,  DAPC-PLF 
Maintainers:  DAPC-OPD 
Programs;  OASPBGU N01  ,  0ASPEGD0S1 


Input  file:  OPDOA SDATA 
Element:  IN  SPEC 


Output  file:  OASOUT 
Element:  ADSPEC 


Fields:  grade 

m spec ode 
commsv  r 
degrees 
dor 

Element:  URATE85 


Fields : 


Element: 


name 

grade 

adspecode 

yrssvc 

CPMRECAP 


Fields:  oct 
nov 
dec 
jan 
feb 
mar 
apr 
may 
jun 
J  ul 
aug 
sep 


Fields: 


oct 

nov 

dec 


mar 

apr 

may 

jun 

Dul 

aug 

sep 


Aliases:  OAS  ASSETER 

URATE85  UTEI 


Categories:  URATE85 
OAS 

0ASPRGUN01 
0 ASPRGDOS 1 


numeric 

officer 

cobol 

development! 


Figure  4.16  First  Example  of  Demonstration  Data 


used  in  describing  metadata  entities  lack  precision  and  need 
tightening  in  follow-on  efforts.  Precise  domains  need  be 
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Model:  P3M 

Reports:  EPMR ,  P3MREP1 

Users:  DAPC-PLP,  DAPC-PLT,  DAPC-PLS 

Maintainers:  DAPC-PLF 

Programs:  P3MPR0GUNO1, 

P3MPRCGD0S1 , 

P3MPROGTRES1 

Input  file:  P3MDATA 

Output  file:  P3MOUTPUT1 

Element:  SEEPAGE84 

Element:  TNGPROG84 

Fields:  mosto 
mosf 

el  through  e8 

Fields:  si 

codes 

npstng 

pstng 

Element:  VALIDMOS 

Element:  CRSLENATR84 

Fields:  cmf 

etsyr 

etsmd 

tdat yr 

tdatmn 

bgrade 

egrade 

title 

Fields:  wks 
att 

Element:  AUTHCUE 
Fields:  e3  through 

e9 

Aliases:  P3M 

P3M 

EPMR 

P3BPROGUNO 1 
P  3MPROGDOS 1 

PIMM  Y 

FAIN 

3PPER 

PI  MM  Y 1 
PIMMY2 

Categories:  P3MPE0GUN01 
P3MPR0GD0S 1 

cobol 

fortran 

l 

i 

Figure  4.17  Second  Example  of  Demon strati on  Data 

determined,  documented  and  enforced  by  edit  criteria. 
Refining  the  user’s  specif icati cn  of  metadata  will 
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facilitate  more  extensive  query  and  report  capabilities.  It 
is  only  possible  with  more  specific  domains  that  a  more  user 
friendly  query  interface  can  be  developed,  possibly  using 
artificial  intelligence  techniques.  Using  artificial 
intelligence  techniques  will  lead  to  a  more  useful  tool 
capable  of  assessing  the  impact  of  change  on  the  databases 
through  sensitivity  analysis  on  the  dictionary. 
Unfortunately,  the  prototype  version  is  not  "instrumented" 
to  capture  user  peculiarities  for  enhancing  friendliness 
and  performance.  Because  dBASE  II  was  used,  the  system 
suffers  poor  performance  in  comparison  to  what  would  be 
enjoyed  using  dBASE  III.  A  full  production  version  would  be 
inordinately  slow  if  not  implemented  in  dBASE  III. 


f.  CONCLUSIONS 


This  thesis  has  investigated  the  use  of  prototypes  and 
data  dictionaries  as  vehicles  fcr  assisting  requirements 
analysis.  It  has  explained  the  advantages  and  disadvantages 
of  prototypes;  provided  guidance  for  their  use;  explained 
tools  that  are  needed  and  provided  a  data  driven  approach  to 
prototyping.  It  has  shown  that  prototyping  is  a  useful 
adjunct  to  the  systems  development  life  cycle  and  is  most 
appropriately  applied  to  Management  Information  System 
applications.  The  most  significant  contribution  of 
prototyping  is  the  establishment  and  maintenance  of 
effective  communications  with  the  user  during  system 
development. 

This  thesis  has  shown  the  importance  of  having  a  data 
dictionary  mechanism  to  capture  the  output  of  prototyping. 
Further,  it  has  explained  metadata  and  its  importance  in 
building  a  system  and  understanding  both  the  user's 
requirements  and  project  management's  requirements.  Clearly 
metadata,  like  user  data,  must  be  organized  into  a  database, 
a  data  dictionary  system.  Organization  of  a  data  dictionary 
can  be  in  accordance  with  one  of  many  different  data  models, 
but  the  relational  offers  the  mcst  promise  for  future  use. 
Consequently,  the  thesis  includes  a  prototype  relational 
dictionary  system. 

The  dictionary  system  demonstrates  the  feasibility  of 
using : 

1.  the  relational  model  for  a  data  dictionary. 

2.  micro-computers  in  a  prototype  effort. 

Although  of  limited  functionality,  the  prototype  was  quickly 
developed  and  offers  considerable  flexibility  in  its  struc¬ 
ture  to  serve  as  an  on-going  aid  in  developing  the  data 
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APPENDIX  A 
USER  MANUAL 

A-  INTRODUCTION 

This  manual  explains  only  what  is  necessary  to  get 
started  using  the  system.  The  system  is  self-prompting  and, 
therefore,  an  extended  narrative  is  unnecessary.  This 
manual  explains  the  use  of  both  the  demonstration  system  and 
the  actual  dictionary.  The  demonstration  system  resides  on 
floppy  disks  and  requires  a  different  initialization 
procedure.  If  you  are  using  the  demonstration  system, 
proceed  to  the  next  section.  If  you  want  to  use  the  actual 
installed  dictionary,  skip  to  section  C.  After 
initialization  both  systems  operate  identically  so,  upon 
completing  initialization,  proceed  to  section  D,  MAIN  menu. 

B.  INITIALIZING  THE  DEMONSTRATION  SYSTEM 

1.  If  the  system  is  on,  turn  it  off  and  remove  all 
floppy  disks. 

2.  Insert  the  floppy  disk  marked  'dBASE  II'  into  drive  A 
and  the  floppy  marked  ’DEMONSTRATION’  into  drive  B. 

3.  Turn  on  the  system  (all  components:  computer,  monitor 
and  printer) . 

4.  Upon  being  prompted  for  the  date,  you  may  enter  it  in 
the  general  form:  MM-DD-YY  ,  or  simply  strike  the 
RETURN  key.  The  same  is  true  for  the  following  prompt 
for  the  time.  If  you  wish  to  have  the  current  time 
available  to  the  system,  the  general  form  of  your 
reply  is :  HH: MM 

5.  Upon  correctly  answering  the  time  and  date  prompts 
you  will  receive  the  following  on  the  screen: 
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u 


fcl 


A  > 

6.  Now  type  in  'DBASE'  and  hit  the  RETURN  key. 

7.  You  will  hear  the  'A'  disk  drive  whirr  and  its  light 
come  on.  After  a  few  seconds  a  message  will  appear: 

Copyright  (C)  1982  RSP  Inc.  ***  d BASE  11/86  Ver  2.4 

I  July  1983 

The  blinking  underline  character  following  the  period 
is  the  cursor.  The  period  is  the  prompt  used  by  dB AS E 

II  and  indicates  that  you  have  accessed  the  dBA  SE  II 
software. 

8.  You  should  now  type  the  following  in  response  to  the 
prompt: 

SET  DEFAULT  TO  B: 

9.  Upon  receiving  the  period  prompt  you  are  now  ready  to 
use  the  demonstration  version  of  tae  data  dictionary. 
At  this  point  proceed  to  section  D,  MAIN  menu. 

C.  INITIALIZING  THE  INSTALLED  DICTIONARY 

This  manual  assumes  that  the  user  is  familiar  with  the 
IBM  PC  sufficiently  to  start  it  up  and  move  to  the 
appropriate  working  directory  upon  which  the  dictionary 
system  is  installed.  For  the  purpose  of  this  manual  it 
assumes  that  directory  {disk  drive)  is  C.  Once  you  have 
moved  to  that  disk  you  are  ready  to  start  up  the  dbase  II 
software.  At  this  point  type  in  "dbase"  and  then  hit  the 
RETURN  key.  You  will  hear  the  "C"  disk  drive  whirr  and  its 
light  ccae  on.  After  a  few  seconds  a  message  that  reads  as 
follows  will  appear: 
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r 


r« 


hi 


Copyright  (C)  1982  P.SP  Inc.  ***  dBASE  11/86  Ver  2.4  1  July 

1983 

The  blinking  underline  character  following  the  period  is  the 
cursor.  The  period  is  the  prompt  for  dBASE  II  and  indicates 
that  you  have  the  accessed  d3ASE  II  software.  Upon 
receiving  the  period  prompt  you  are  now  ready  to  use  the 
actual  version  of  the  data  dictionary.  Proceed  to  the  next 
section,  MAIN  menu. 

D.  MAIN  MENU 

Type  in  the  following  and  the  main  menu  for  the  data 
dictionary  will  appear:  DO  MAIN  (all  capital  letters  aren't 
necessary,  but  it's  best  for  this  particular  system  to  set 
the  "caps  lock"  key  so  that  you  are  always  in  uppercase.  To 
set  the  "caps  lock"  key  just  strike  the  key  so  marked  once) . 

The  MAIN  menu  permits  selection  of  the  major  function 
you  wish  to  perform.  Upon  selecting  a  major  function,  enter 
the  number  associated  and  another  menu  will  appear.  Please 
wait  for  the  "WAITING"  message  to  appear  before  typing  the 
number  of  the  major  function  you  want.  Upon  selecting  a 
major  function  another  menu  will  appear  (See  example  of  the 
Main  Menu  on  the  next  page) .  Use  the  instructions  of  this 
manual  for  working  with  those  menus.  After  a  period  of  use 
you  will  become  familiar  with  the  specific  functions  of  the 
system,  such  as  adding  a  model  record.  If  you  find  the  use 
of  the  menus  tedious  at  that  time,  you  can  execute  any 
specific  program  by  entering  "DC  program  name".  For 
example,  to  directly  execute  the  program  to  change  an  office 
record  you  would  enter  "DO  CHG-CFFICE".  To  nelp  you  learn 
the  specific  program  names  they  are  provided  in  the  menus  in 
parentheses  beside  the  explanation  of  a  choice.  This  means 
that  once  you  have  the  period  prompt  mentioned  above,  you 
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can  directly  accomplish  a  particular  function  by  executing 
the  associated  program  and  not  stepping  through  the  menus. 

This  is  the  MAIN  menu  for  the  data  dictionary  system. 

The  system  allows  you  to  add,  change,  or  delete  records  and 
to  process  queries.  Please  enter  the  number  of  the  function 
you  wish  to  perform: 


0  to  quit 

1  add  a  new  record 

2  change  a  record 

3  delete  a  record 

4  run  a  query 

5  print  a  report 

Enter  the  selection  here 
WAITING 


(ADD-MENU) 
(CH3-MEN  U) 
(DEL- MENU) 
(QERY-MENU) 
(REPT-MENU) 


E.  ADD  SUBSYSTEM 

There  are  two  methods  of  accessing  the  ADD-MENU;  either 
by  typing  in  the  command  '  DO  ADD-MENU'  or  by  selecting 
option  #1  from  the  MAIN-MENU.  In  either  case,  the  following 
menu  will  appear; 

ADD  MENU 


0  to  quit 


1  Model  (ADD-MOEEL) 

2  Office  (ADD-OFFICE) 

3  Report  (ADD-REP) 

4  Program  (ADD-PRO) 

Enter  the  selection  here 
WAITING  0 


5  Pile  (ADD- FI) 

6  Element  (ADD-EL) 

7  Field  (ADD-FE) 

8  Alias  (ADD-AL) 

9  Category  (ADD-CAT) 


Selecting  0  from  the  ADD-MENU  will  return  you  to  either 
the  MAIN-MEND  or  a  blank  screen  (if  the  ’DO  ADD-MEND* 
command  was  used). 

To  add  a  new  record,  press  the  number  associated  with 
the  entity’s  type.  The  system  will  prompt  you  for  the  unigue 
name  of  the  entity  you  wish  to  add.  If  that  name  is  not 
truly  unique,  the  system  will  tell  you  so  and  not  permit  you 
to  add  a  new  record.  If  the  name  is  unique  a  screen  will 
appear  with  the  fields  highlighted  to  include  blank  spaces 
for  entering  data  for  the  new  record.  Simply  fill  in  the 
appropriate  data  items  and  move  from  field  to  field  (DSING 
THE  CURSOR)  until  you  have  filled  in  all  the  blank  fields 
for  which  you  have  data.  Once  you  have  assured  yourself 
that  all  data  items  you  have  entered  are  correct,  hit  the 
RETURN  key  and  the  record  will  he  added  to  the  database. 

(Note:  after  the  RETURN  key  has  been  hit  changes  can  only  be 
made  using  the  CHANGE  subsystem) 

Cnee  you  have  entered  a  record  by  hitting  the  RETURN  key 
you  will  be  prompted  if  you  wish  to  add  another  record  to 
the  database.  To  stop  adding  records,  hit  the  space  bar  and 
RETURN.  As  soon  as  the  RETURN  key  is  hit  you  will  be 
returned  to  either  the  ADD-MENU  or  the  dbase  II  system. 

F.  CHANGE  SUBSYSTEM 

There  are  two  methods  of  accessing  the  CHANGE  menu  , 
either  typing  in  the  command  "DC  CHG-MENU"  and  striking  the 
return  key  or  selecting  option  2  from  MAIN  menu.  In  either 
case  the  CHG  menu  will  appear  as  follows: 

This  is  the  CHANGE  menu.  It  permits  you  to  change  records  in 
any  file.  Please  enter  the  number  of  the  function  you  wish  to 
perform . 

0  to  quit 

1  Model  (CHG-MODEL)  5  Pile  (CHG-FI) 
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2  Office  (CHG-OFFICE) 

3  Report  (CHG-REP) 

4  Program  (CHG-PRO) 


6  Element  (CHG-EL) 

7  Field  (CHG-FE) 

8  Alias  (CHG- AL) 

9  Category  (CHG-CAT) 


Enter  the  selection  here 
WAITING 

When  selecting  from  the  menu  always  wait  for  the  system  to 
prompt  you  with  the  words  “WAITING".  Selecting  0  will 
return  you  to  either  the  MAIN  menu  or  a  blank  screen  (if  the 
"DO  CHG-MENU"  command  was  used)  . 

Regardless  of  whatever  type  entity  you  wish  to  change, 
the  system  will  require  you  to  provide  the  entity's  unique 
name.  To  quit  changing  records,  hit  the  space  bar  and 
RETURN.  The  system  will  then  find  the  record  for  that 
entity  and  present  it  on  the  screen  for  editing.  Having 
completed  the  editing,  the  record  can  be  stored  back  in  the 
dictionary  by  moving  the  cursor  down  through  the  last  field 
using  the  RETURN  key.  If  there  are  any  relationships  for 
which  the  entity  is  an  object  of,  the  particular  program  you 
are  using  will  prompt  you  if  you  wish  to  add  or  delete 
entities  associated  with  the  one  you  just  changed.  For 
example,  if  you  edited  the  record  for  a  particular  FIELD, 
then  the  system  will  prompt  you  if  you  wish  to  add  or  delete 
verbal  type  records  for  ELEMENTS  that  contain  the  FIELD.  A 
change  in  the  unique  name  of  an  entity  will  be  automatically 
changed  in  all  verbal  type  records  for  you  by  the  software. 
For  example,  if  you  changed  the  unique  name  of  a  FIELD  the 
software  will  change  all  CONTAINS  records  accordingly  for 
you . 
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G.  DELETE  SUBSISTED 


There  are  two  methods  of  accessing  the  DELETE  menu  , 
either  typing  in  the  command  "DO  DEL-MENU"  and  striking  the 
return  key  or  selecting  option  3  from  MAIN  menu.  In  either 
case  the  DELETE  menu  will  appear  as  follows: 

This  is  the  DELETE  menu.  It  permits  you  to  delete  records 
from  any  file.  Please  enter  the  number  of  the  function  you 
wish  to  perform. 

0  to  g  ui  t 

1  Model  (DEL-MODEL)  5  File  (DEL-FI) 

2  Office  (DEL-OFFICE)  6  Element  (DEL-EL) 

3  Report  (DEL-REP)  7  Field  (DEL-FE) 

4  Program  (DEL-PEC)  8  Alias  (DEL-AL) 

9  Category  (DEL-CAT) 

Enter  the  selection  here 
WAITING 

Select  the  type  entity  you  wish  to  delete  by  entering  the 
number  associated  with  the  entity's  type.  The  particular 
program  selected  will  prompt  you  for  the  unigue  name  of  the 
entity.  To  guit  deleting  records,  hit  the  space  bar  and 
RETURN,  otherwise  type  in  the  name  and  hit  RETURN.  If  you 
have  given  the  unique  name  correctly,  the  system  will  find 
that  entity's  record  and  ask  if  you  are  sure  that  is  the  one 
you  wish  to  delete.  If  you  answer  I,  the  system  will  delete 
the  associated  record,  not  merely  mark  it  for  deletion. 
Further,  the  system  will  automatically  delete  ail  associated 
verbal  type  records  for  the  particular  entity  deleted.  For 
example,  if  you  chose  to  delete  the  FIELD  named  Grade,  and 
that  field  is  contained  in  the  ELEMENT  Aspec,  then  all  the 
CONTAINS  records  showing  Aspec  as  containing  the  field  will 
also  be  deleted. 


70 


H.  QUERY  SUBSYSTEM 


There  are  two  methods  of  accessing  the  QUERY  menu, 
either  by  typing  in  the  command  "DO  REPT-MENU"  and  striking 
the  return  key  or  selecting  option  4  from  the  MAIN  menu.  In 
either  case  the  QUERY  menu  will  appear  as  follows: 

This  is  the  QUERY  menu.  It  permits  you  to  make 
ad-hoc  inquiries.  Queries  are  either  of  the 
•forward*  type  where  an  entity  is  the  subject  and 
you  specify  the  verb  and  object,  or  of  the  ’backward’ 
type  where  the  entity  you  give  is  the  object  of  an 
action  and  subject. 

QUERY  MENU 

1)  Forward  type  (i.e.  P3M  calls  what  programs  ?)  (FORTREV) 

2)  Backward  type  (i.e.  P3M  is  used  by  what  offices  ?)  (BAKTREV) 

3)  Forward  type  for  aliases  (  indicate  type  and  system 
provides  all  aliases)  (FORAX) 

4)  Backward  type  for  aliases  (give  entity  name  and  system 

(BAKAL)  provides  all  aliases  for  that  particular  entity) 

5)  Forward  type  for  categories  (indicate  type  and  system 

gives  categories)  (FORCAT) 

6)  Backward  type  for  categories  (give  entity  name  and 
(BAKCAT)  system  gives  all  categories  that  entity  is  in) 

0  to  gait 

Enter  the  selection  here 
WAITING  0 

The  system  provides  two  types  of  gueries,  forward  and 
backward.  Forward  means  the  user  is  presented  columns  of 
relations  from  which  to  pick.  The  columns,  following  the 
forward  flow  of  the  English  language,  are  subject,  verb  and 


object  respectively.  The  user  provides  the  unique  name  of 
the  entity  beside  its  type  in  the  subject  column;  then  marks 
one  appropriate  entry  in  the  verb  column  and  one 
appropriate  entry  in  the  object  column.  For  example,  to 
answer  the  question  "What  models  does  the  office  with  symbol 
DAPC-PLF  use  ?"  see  Figure  A.1  which  depicts  how  the  screen 
of  the  FORTREV  program  would  appear  and  Figure  A. 2  depicts 
the  output.  Verb  and  object  choices  must  be  appropriate  for 
the  subject  in  that  it  is  not  possible  to  get  any  response 
from  a  query  marked  for  which  there  is  no  relationship 
defined.  For  example,  marking  the  screen  of  the  FORTREV 
program  to  answer  the  question  "What  models  contain  what 
fields  ?  "  would  elicit  no  response  when  processed. 


SUBJECTS 

Of f ice: DAPC-PLF 
Model: 

File: 

Element: 


VERBS 


Uses:X : 
Maintains:  : 

Calls:  : 
Inputs:  : 
Outputs:  : 


Contains: 


OBJECTS 


Reports: 
Models: X 

Programs: 

Files: 


Elements: 

Fields: 


To  quit  put  an  X  in  this  field 


Put  the  unique  name  of  the  entity  you  are  querying  about 
in  the  field  next  to  the  entity's  type.  Then  place  an  X 
in  one  appropriate  verb  field  for  that  entity  type  and 
an  X  in  i  appropriate  object  field. 

I.E.  Office: DAPC-PLF  :  Uses:X:  Models:X: 

To  process  query  move  cursor  through  remaining 
fields  using  RETURN  key. 


The  office  DAPC-PLF  uses  the  following  models 

P3M 

OAS 

Strike  any  key  to  continue. .  . 

WAITING 


Figure  A. 2  Example  of  Forward  Query  Output 

The  backwards  approach  is  implemented  by  presenting, 
from  left  to  right,  columns  of  objects,  verbs  and  then 
subjects.  Thus,  to  answer  a  question  such  as  "What  offices 
use  the  P3M  model  ?"  the  screen  of  the  BAKTREV  program 
would  be  marked  as  shewn  in  Figure  A. 3  and  Figure  A. 4 
depicts  how  the  output  from  this  query  would  appear. 

Because  the  ALIAS  and  CATEGORY  relations  are  each  a  special 
case,  they  are  given  their  own  respective  forward  [FCRAL  S 
FORCAT)  and  backward  (BAKAL  6  BAKCAT)  query  programs. 

I.  REPOBTS  SOBSTSTEH 

There  are  two  methods  of  accessing  the  REPORT  menu, 
either  by  typing  in  the  command  "DO  REPT-flENU"  and  striking 
the  RETURN  key  or  selecting  option  5  from  the  MAIN  menu.  In 
either  case  the  menu  will  appear  as  follows: 


OBJECTS  VERBS  SUBJECTS 


Model: P3M 

:  Is  used 

by:  X : 

Office: X 

Report: 

:  Is  maintained 

by:  : 

Program: 

File: 

:  Is  called 

:  Is  inputted 

Is  outputted 

by:  : 
by :  : 
by:  : 

Model : 

Element: 

Field:  : 

Is  contained 

in:  : 

File: 

Element:  : 

To  quit  put  an  X  in  this  field:  : 

Enter  the  name  of  the  entity  besides  its  type  and  then 
mark  1  verb  field  and  1  subject  field.  To  process 
query  move  cursor  down  through  remaining  fields 
using  RETURN  key. 


Figure  A. 3  Example  of  a  Backward  Retrieval 


The  model  P3M 

DAPC-PLP 

DAFC-PLT 

DAPC-FLS 

DAPC-PLF 


is  used  by  the  following  offices 


Strike  any  key  to  continue  .. 
WAITING 


This  is  the  REPORT  menu.  It  permits  you  to  print 
summary  reports  from  the  dictionary. 

REPORT  MENU 

1)  for  a  specific  Model  all  users,  maintainers, 
input  S  output  files,  programs  called  (SUMOD) 

2)  for  a  specific  Report  all  users  and  models  outputting  it 

(StJMREP) 

3)  for  a  specific  Office  all  models  used,  all 
models  maintained,  and  reports  used.  (SUMOFF) 

4)  for  a  specific  File  all  models  it  provides  input  to, 
receives  output  from,  and  elements  it  contains  (SUMFIL) 

0  to  quit 

Enter  the  selection  here 
WAITING 

Before  executing  any  Report  menu  option  be  sure  the 
printer  is  both  turned  on  and  is  "on  line".  Failure  to  have 
the  printer  turned  on  may  result  in  your  being  thrown  out  of 
the  data  dictionary  system  and  dBASE  II  and,  therefore,  to 
reinitialize.  Select  the  report  program  you  wish  to 
execute.  The  system  will  then  prompt  you  for  the  unique  name 
of  the  entity  concerned.  For  that  specific  entity,  the 
system  will  then  provide  a  printed  summary  report  which 
provides  all  entities  which  have  a  direct  relationship  with 
the  entity.  Thus,  if  the  you  provide  the  unique  name  of  a 
Model,  the  printed  report  would  list: 

1.  All  offices  which  use  the  Model. 

2.  All  offices  which  maintain  the  Model. 

3.  All  programs  the  Model  calls. 
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4.  All  reports  the  Model  outputs. 

5.  All  files  the  Model  either  inputs  from  or  outputs  to. 
For  example,  if  you  wished  to  have  a  summary  report  about 
for  the  P3M  model  you  would  select  option  1  from  the  Reports 
menu  for  execution  of  the  SUMOD  program.  The  system  would 
then  prompt  you  as  follows: 

Please  enter  the  unigue  name  of  the  Model 
Hit  the  space  bar  and  RETURN  to  guit:?3M 


The  Model  P3 M 

Is  used  by  the  following  offices: 

DAPC-PLP 

DAPC-PLT 

DAPC-PLS 

DAPC-PLF 

Is  maintained  by  the  following  offices  with 
the  point  of  contact: 

DAPC-PIF  KALINICH 

Inputs  the  following  files: 

P3MDATA 

Outputs  to  the  following  files: 

P3M0UTPCT1 

Outputs  the  following  reports: 

EPMR 

P3MREP1 

Calls  the  following  programs 

P3MPE0GUN01 
P3MPR0GD0S1 
P3MPR0GTRES 1 

Strike  any  key  to  continue 
WAITING 


Figure  A. 5  Example  of  Report  Output 


J.  TERHINATIIG  A  SESSION 


Having  completed  whatever  wcrk  you  wished  to  accomplish 
you  will  now  want  to  shut  down  the  dictionary  system. 

1.  If  you  have  a  menu  up  on  the  screen,  select  "0"  and 
exit.  If  another  menu  appears,  exit  in  the  same 
manner.  You  will  now  have  the  period  prompt  on  the 
screen  indicating  you  are  out  of  the  dictionary 
system. 

2.  Type  in  the  word  "QUIT"  and  hit  the  RETURN  key. 

3.  If  you  are  using  the  Jem cnstr atron  system  you  will 
get  the  following  prompt: 

A> 

If  you  are  using  the  installed  system  you  will  get 
the  following  prompt: 

Co 

4.  If  you  were  using  the  installed  system,  turn  off  the 
machine  ani  you  are  done.  If  you  were  using  the 
demonstration  system,  remove  the  floppy  disks  and 
store  them  in  their  paper  sleeves. 


APPENDIX  B 

DATA  DICTIONARY  SYSTEM'S  DATA  ELEMENTS 

The  following  is  an  alpnabetic  listing  of  the  fields 
used  in  the  dictionary  system.  An  asterisk  following  a  rile 
name  denotes  the  field  being  discussed  as  being  key  to  that 
file. 

dBAS 2  II  FIELD  NAME  /  ACRONYM:  aname 
FULLNAME:  alias  name 
FORMAT:  mixed 
LENGTH:  15 

FILES  WHERE  USED :  Alias 

DESCRIPTION:  Name  by  which  any  entity  is  known 
other  than  its  official  name. 

dBASE  II  FIELD  NAME  /  ACRONYM:  bldg 
FULLNAME:  building 
FORMAT:  mixed 
LENGTH:  15 

FILES  WHERE  USED:  Office 

DESCRIPTION:  The  building  in  which  an  office 
is  located. 

dBASE  II  FIELD  NAME  /  ACRONYM:  cat 
r^LLNAME:  category 
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FORMAT:  alphabetic 
LENGTH:  16 

FILES  WHERE  USED:  Category 

DESCRIPTION:  The  category  in  which  an 
entity  would  be  placed  such  as  a  field  being  a 
continuation  rate. 

dBASE  II  FIELD  NAME  /  ACRONYM:  comments 
FULLNAME:  comments 
FORMAT:  mixed 
LENGTH:  45 

FILES  WHERE  USED:  office 

DESCRIPTION:  Any  narrative  information 
that  illuminates  on  the  office  cccuring 
in  the  record. 

dBASE  II  FIELD  NAME  /  ACRONYM:  datatype 
FULLNAME:  datatype 
FORMAT:  alphabetic 
LENGTH:  3 

FILES  WHERE  USED:  Field 

DESCRIPTION:  The  type  of  data  that  a  field  could 
hold.  The  entry  can  be  either  A  for  alphabetic, 

N  for  numeric,  AN  for  both  or  S  for  special. 

For  example,  for  a  field  that  could  hold  all  three 
this  entry  would  be  ANS. 

dBASE  II  FIELD  NAME  /  ACFONYM:  date 


FULLNAME:  date 


FORMAT:  numeric 
LENGTH:  6 

FILES  WHERE  USED:  Element 

DESCRIPTION:  This  is  date  an  element  vas  created. 
dBASE  II  FIELD  NAME  /  ACRONYM:  description 
FULLNAME:  description 
FORMAT:  alphabetic 
LENGTH:  45 

FILES  WHERE  USED:  Report,  Model,  Program, 

File,  Element,  Field 

DESCRIPTION:  Verbal  narrative  illuminating  on  the 
entity  it  is  associated  with. 

dBASE  II  FIELD  NAME  /  ACRONYM:  domain 
FULLNAME:  domain 
FORMAT:  mixed 
LENGTH:  45 

FILES  WHERE  USED:  Field 

DESCRIPTION:  The  range  of  acceptable  values 
a  field  can  take  on. 

dBASE  II  FIELD  NAME  /  ACRONYM:  editcri 
FULLNAME:  edit  criteria 
FORMAT:  mixed 


LENGTH:  45 


FILES  WHERE  OSED:  Field 


A 

H 

r* 


lii 
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DESCRIPTION:  Rules  used  to  constrain  and 
edit  what  values  can  occur  in  a  field. 

dBASE  II  FIELD  NAME  /  ACRONYM:  elname 
FULLNAME :  element  name 
FORMAT:  mixed 
LENGTH:  12 

FILES  WHERE  USED:  Element* 

DESCRIPTION:  Unique  name  of  file  element  (not  a  data 
element  or  field,  but  the  partition  of  a  file). 

dBASE  II  FIELD  NAME  /  ACRONYM:  ename 

FULLNAME:  entity  name 

FORMAT:  mixed 

LENGTH:  15 

FILES  WHERE  USED:  Alias*,  Categ cry *, Contains , 

Calls,  Uses,  Outputs,  Inputs,  Alias 

DESCRIPTION:  The  unique  name  associated  with  ar. 
entity  such  as  what  could  legally  occur  in  mdl 
for  a  Model.  This  value  would  be  the  object 
of  one  of  the  verb  relations. 

uBASE  II  FIELD  NAME  /  ACRCNYM:  enamel 

FULLNAME:  entity  name  #1 

FC  RM  AT:  mixed 

LENGTH:  15 
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FILES  WHERE  OS  ED :  contain^* ,  outputs*.  Inputs*, 
Calls* 

DESCRIPTION:  The  unique  name  associated  with  an 
entity  and  the  subject  of  a  vert  relation. 


dBASE  II  FIELD  NAME  /  ACRONYM:  etype 
FULL  NAME :  entity  type 
FORMAT:  alphabetic 
LENGTH:  10 

FILES  WHERE  USED:  Contains,  Outputs,  Inputs, 
Calls 

DESCRIPTION :  Type  of  entity  that  ename 
specifies  such  as  Model,  Report,  etc. 

dEASE  II  FIELD  NAME  /  ACRONYM:  etypel 
FULLNAME:  entity  type  #1 
FORMAT:  alphabetic 
LENGTH:  10 

FILES  WHERE  USED:  Contains*,  Outputs*, Int uts*. 
Calls* 

DESCRIPTION:  Type  of  entity  that  enamel  is 
specifying  such  as  Model,  Report,  etc. 

dBASE  II  FIELD  NAM  '  ACRONYM:  fid 


FULLNAME:  field 


FORM  AT:  mixed 


LENGTH:  15 


FILES  WHERE  USED:  Field* 


DESCRIPTION:  The  unique  name  of  a  field. 


dBASE  II  FIELD  NAME  /  ACRONYM:  fname 


FULL NAME:  file  name 


FORMAT:  mixed 


LENGTH:  16 


FILES  WHERE  USED:  File* 


DESCRIPTION:  The  unique  name  of  a  file. 


dBASE  II  FIELD  NAME  /  ACRONYM:  fuilname 
FULLNAME:  full  name 
FORMAT:  mixed 
LENGTH:  25 

FILES  WHERE  USED:  Report,  File 

DESCRIPTICN :  The  non-unique  and  fully  expanded 
name  of  either  a  report  or  file. 


dBASE  II  FIELD  NAME  /  ACRONYM:  language 
FULLNAME:  language 


FORMAT:  mixed 


LENGTH:  10 


FILES  WHERE  USED:  Program 


DESCRIPTION:  The  computer  language 
a  program  is  written  in,  such  as 
FORTRAN  77. 

dBASE  II  FIELD  N AWE  /  ACRONYM:  Istupdate 
FOLLNAME:  last  update 
FORMAT:  numeric,  YYMMDD 
LENGTH:  6 

FILES  WHERE  USED:  File 

DESCRIPTION:  The  most  recent  date  of 
a  file  having  been  updated. 

dBASE  II  FIELD  NAME  /  ACRONYM:  length 
FULLNAME;  length 
FORMAT:  numeric 
LENGTH:  3 

FILES  WHERE  USED:  Field 

DESCRIPTION:  The  size  of  a  field  in  bytes. 

dBASE  II  FIELD  NAME  /  ACRONYM:  location 
FULLNAME:  location 
FORMAT:  mixed 
LENGTH:  15 

FILES  WHERE  USED:  Model,  Program 
DESCRIPTION:  The  file  where  a  program  or  model 


84 


is  stored  on  the  computer. 

dBASE  II  FIELD  NAME  /  ACRONYM:  mdl 

FULLNAME:  model 

FORMAT:  mixed 

LENGTH:  8 

FILES  WHERE  USED:  Model*,  Maintains* 

DESCRIPTION:  The  unique  abbreviation  or  acronym 
associated  with  a  Model. 

d3 AS E  II  FIELD  NAME  /  ACRONYM:  media 
FULLNAME:  storage  media 
FORMAT:  alphabetic 

LENGTH:  10 

FILES  WHERE  USED:  File 

DESCRIPTION:  The  type  medium  used  to  store 

a  file,  i.e.  tape  or  disk. 

dBASE  II  FIELD  NAME  /  ACRONYM:  method 
FULLNAME:  methodology 
FORMAT:  alphabetic 
LENGTH:  45 

FILES  WHERE  USED:  Model 

DESCRIPTION:  The  Operations  Research  solution 
techniques  used  by  a  model  such  as  Linear  Programming. 


85 


dBASE  II  FIELD  NAME  /  ACRONYM:  aodelpoc 
FULLNAME:  model  point  of  contact 
FORMAT:  alphabetic 
LENGTH:  15 

FILES  WHERE  USED:  Maintains 

DESCRIPTION:  The  individual  to  he  contacted 
regarding  maintanance  of  a  model. 

dBASE  II  FIELD  NAME  /  ACRONYM:  aodname 
FULLNAME:  model  name 
FORMAT:  mixed 
LENGTH:  30 

FILES  WHERE  USED:  Model 

DESCRIPTION:  The  fully  expanded,  non-unigue 
name  of  a  Model. 

dBASE  II  FIELD  NAME  /  ACRONYM:  nulls tat 
FULLNAME:  nullstatus 
FORMAT:  alphabetic 
LENGTH:  1 

FILES  WHERE  USED:  Field 

DESCRIPTION:  Indicates  whether  a  field  can  have 
the  null  status  or  seme  value  must  always  be 
present. 

d3ASE  II  FIELD  NAME  /  ACRONYM:  number 


FULLNAME:  number 


FORMAT:  mixed 
LENGTH:  9 

FILES  WHERE  USED:  Office 

DESCRIPTION:  The  number  assigned  to  a  report  by 
the  computer  operations  organization  of  MILPERCEN. 

dBASE  II  FIELD  NAME  /  ACRONYM:  cfc 

FULLNAME:  office  symbol 

FORMAT:  alphabetic 

LENGTH:  9 

FILES  WHERE  USED:  Office*,  Uses* 

DESCRIPTION:  The  unigue  symbol  which  identifies 
an  office  of  either  DCSPLAHS  or  some  other 
organization,  for  example  PERSINSD. 

dBASE  II  FIELD  NAME  /  ACRONYM:  cname 

FULLNAME:  office  name 

FORMAT:  mixed 

LENGTH:  35 

FILES  WHERE  USED:  File 

DESCRIPTION:  The  expanded,  non-unigue  name  of  an 
office,  such  Deputy  Chief  of  Staff  for  Plans 
for  DCSPLANS. 

dBASE  II  FIELD  NAME  /  ACRONYM:  cutfrmat 
FULLNAME:  output  format 
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FORMAT:  alphabetic 
LENGTH:  15 

FILES  WHERE  USED:  Report 

DESCRIPTION:  The  form  a  report  takes  such  as  hard  copy, 
tape,  or  microfice. 

dBASE  II  FIELD  NAME  /  ACRONYM:  phone 
FULLNAME:  telephone  number 
FORMAT:  mixed 
LENGTH:  21 

FILES  WHERE  USED:  Office 

DESCRIPTION:  The  telephone  number  of  an  office. 
d9ASE  II  FIELD  NAME  /  ACRONYM:  pname 

FULLNAME:  program  name 

FORMAT:  alphabetic 

LENGTH:  15 

FILES  WHERE  USED:  Program* 

DESCRIPTION:  The  unique  identifier  of  a  prograa- 

dBASE  II  FIELD  NAME  /  ACRONYM:  periodicity 
FULLNAME:  periodicity  of  entity 
FORMAT:  mixed 
LENGTH:  4 

FILES  WHERE  USED:  Report,  Model,  Program 

DESCRIPTION:  How  frequently  a  report,  program, 
or  model  is  executed  or  produced.  Coded  by 
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2W  means  twice  monthly,  3Q  means  thrice  guarterly 

dBASE  II  FIELD  NAME  /  ACRONYM:  poc 
FULLNAME:  point  of  contact 
FORMAT:  alphabetic 
LENGTH:  15 

FILES  WHERE  USED:  Office,  File,  Element,  and 
Field 

DESCRIPTION:  The  individual  to  be  contacted  if 
having  problems  or  need  information  about 
the  associated  entity. 

dBASE  II  FIELD  NAME  /  ACRONYM:  purpose 
FULLNAME:  purpose 
FORMAT:  alphabetic 
LENGTH:  45 

FILES  WHERE  USED:  Report,  Model,  Program, 

File,  Field,  and  Element 

DESCRIPTION:  The  function  and  reason  for 
existence  of  an  entity. 

dBASE  II  FIELD  NAME  /  ACRONYM:  rname 
FULLNAME:  report  name 
FORMAT:  mixed 
LENGTH:  10 

FILES  WHERE  USED:  Report* 


DESCRIPTION:  The  unique  identifier  of  a  Report. 
dBASE  II  FIELD  NAME  /  ACRONYM:  seqnum 
FULLNAME:  sequence  number 
FORMAT:  numeric 
LENGTH:  5 

FILES  WHERE  USED:  Element 

DESCRIPTION:  Location  of  an  element  within 
the  file  that  holds  it.  Elements  are 
both  named  and  marked  by  their  sequential 
position  in  the  file. 

dBASE  II  FIELD  NAME  /  ACRONYM:  room 

FULLNAME:  room  number 

FORMAT;  mixed 

LENGTH:  6 

FILES  WHERE  USED:  Office 

DESCRIPTION:  Room  where  an  office  is  located. 

dBASE  II  FIELD  NAME  /  ACRONYM:  runame 
FULLNAME;  run  stream  name 
FORMAT:  mixed 
LENGTH:  15 

FILES  WHERE  USED:  Model 

DESCRIPTION:  The  unique  name  of  a  run  stream  (Job 
Control  Language  procedure)  that  results  in 
Model  being  executed. 
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dBASE  II  FIELD  HAKE  /  ACF.CNYM:  size 
FULLNAME:  size 
FORMAT:  numeric 
LENGTH:  3 

FILES  WHERE  USED:  Element 

DESCRIPTION:  Length  in  bytes  of  an  occurrence  in  an 
element.  All  occurrences  in  an  element  are  the  same  size 
and  the  format  of  the  element  is  likened  to  a  record. 

dBASE  II  FIELD  NAME  /  ACRONYM:  seclass 

FULLNAME:  security  ciassif icaticn 

FORMAT:  alphabetic 

LENGTH:  2 

FILES  WHERE  USED:  Report,  Field 

DESCRIPTION:  Highest  level  of  classified 
information  the  entity  contains.  Coded 
as  U,  C,  S  or  TS. 

dEASE  II  FIELD  NAME  /  ACRONYM:  source 
FULLNAME:  source 
FORMAT:  mixed 
LENGTH:  15 

FILES  WHERE  USED:  Field 

DESCRIPTION:  The  document  or  source 
which  explains  or  specifies  what  values 
can  occur  in  a  field.  For  example, 

AR  6  11-201  specifies  what  would  occur  in  a 


field  for  enlisted  military  occupational 
specialty. 

dBASE  II  FIELD  NAME  /  ACRONYM:  status 
FULLNAME:  development  status 
FORMAT:  alphabetic 
LENGTH:  15 

FILES  WHERE  USED:  Report,  Model,  Program, 

File,  Field 

DESCRIPTION:  The  development  status  of  an  entity  such  as 
test,  operational,  retired. 

dBASE  II  FIELD  NAME  /  ACRONYM:  version 

FULLNAME:  version 

FORMAT:  numeric 

LENGTH:  3 

FILES  KHE3Z  USED:  Program* 

DESCRIPTION:  The  edition  number  of  a  program  and 
therefore  an  indicator  of  uniqueness.  For  example, 
ADSPEC3. 
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ADMAIN.PfiG 

to  add  new  maintainers  (offices)  of  an  existing  model 
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check  to  delete  models  from  outputs  file  that  used  to  output  file 
'Do  you  wish  to  delete  a  Model  that  outputs  this  report  ?' 
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Enter  the  symbol  for  the  office  using  this  report  and  RETURN 
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while  flag 


arout.prg  to  add  model  that  outputs  a  preexisting  report 
to  add  model  to  outputs  file  for  a  preexisting  report 
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say  Alias  get  amaname 

say  Type  of  entity  (i.e.  MODEL,  or  BEPOBT)  get  ametype 
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